ユーザーの参照

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

Read User Rolesアクションカードは、Office 365テナントでアクティブ化されているロールのみを参照します。また、このカードはデフォルトのシステムロールのみを参照します。カスタムロールは参照しません。

入力

フィールド 定義 タイプ 必須
ユーザー
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 ユーザーの一意識別子。 文字列
表示名 ディレクトリロールの表示名。 文字列
説明 ディレクトリロールの説明。 文字列
ロールテンプレートID このロールの基盤となっているdirectoryRoleTemplateのID。POST操作を使ってテナントのディレクトリロールをアクティブ化する場合は、このプロパティーを指定する必要があります。ディレクトリロールがアクティベートされると、このプロパティーは参照専用になります。 文字列

例:

コピー
{
"@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"
}
(欠落または不良スニペット)