Read User Roles（ユーザーロールの読み取り）

Office 365のユーザーに割り当てられているロールを取得します。

Read User Rolesアクションカードは、Office 365テナントでアクティブ化されているロールのみを参照します。

また、このカードはデフォルトのシステムロールのみを参照します。カスタムロールは参照しません。

入力

フィールド定義タイプ必須

フィールド	定義	タイプ	必須
ユーザー
Id or Username（IDまたはユーザー名）	Office 365ユーザーのユーザーIDまたはユーザー名。これはユーザーのユーザープリンシパル名（UPN）です。UPNは、ユーザー名とドメインを`@`区切り文字で組み合わせたものです。たとえば、`john.doe@somedomain.com`となります。ユーザーのメールアドレスが考えられますが、常にそうであるとは限りません。	テキスト	TRUE

ユーザー

Id or Username（IDまたはユーザー名）

Office 365ユーザーのユーザーIDまたはユーザー名。これはユーザーのユーザープリンシパル名（UPN）です。UPNは、ユーザー名とドメインを@区切り文字で組み合わせたものです。

たとえば、john.doe@somedomain.comとなります。ユーザーのメールアドレスが考えられますが、常にそうであるとは限りません。

テキスト

TRUE

UPN入力の文字列が「$」で始まるときは、「/users」の後のスラッシュ（/）を削除し、UPN値を括弧と単一引用符で囲みます。例：/users('$AdeleVance@contoso.com')。「Microsoft Graphの既知の問題」を参照してください。

UPN入力値を使用してB2Bユーザーを検索するには、#文字を%23としてエンコードします。例：/users/AdeleVance_adatum.com%23EXT%23@contoso.com。

出力

フィールド	定義	タイプ
ID	ユーザーの一意識別子。	テキスト
Display Name（表示名）	ディレクトリロールの表示名。	テキスト
Description（説明）	ディレクトリロールの説明。	テキスト
Role Template ID（ロールテンプレートID）	このロールの基盤となっている`directoryRoleTemplate`のID。 POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティベートされると、このプロパティーは読み取り専用になります。	テキスト

例：

コピー

1
2
3
4
5
6
7
8
{
    "@odata.id": "https://graph.microsoft.com/v2/28d029a7-1d11-4ce0-85f5-d9502f2cd5b1/directoryObjects/06265c7a-1373-4033-8d26-3a9a04226e15/Microsoft.DirectoryServices.DirectoryRole",
    "id": "06265c7a-1373-4033-8d26-3a9a04226e15",
    "deletedDateTime": null,
    "description": "Can reset passwords for non-administrators and Helpdesk Administrators.",
    "displayName": "Helpdesk Administrator",
    "roleTemplateId": "729827e3-9c14-49f7-bb1b-9608f156bbb8"
}

Read User Roles（ユーザーロールの読み取り）

入力

出力

関連項目