注
Azure Active Directory は Microsoft Entra ID に名称変更されました。 詳細情報
Microsoft Dataverse には、AAD ユーザー (aaduser) という名前の仮想テーブルが含まれています。 この仮想テーブルは、Azure Active Directory (AAD) への接続を提供し、AAD 組織内のユーザーに関するデータを返します。 この機能を使用するために仮想テーブルの構成は必要ありません。 これはオンラインのみの機能です。
注
AAD ユーザーの結果は、使用されている場所によって異なる場合があります。 Dataverse の AAD ユーザーは、組織の Azure AD のユーザーの完全な一覧を提供します。 Dataverse for Teams の AAD ユーザーは、チームのメンバーでもあるすべての AAD ユーザーを提供することに限定されます。
AAD ユーザーは、グループまたは配布リストを返しません。
AADUser を使用したルックアップ
この仮想テーブルへの参照は、Power Apps ポータル内から簡単に追加できます。
Permissions
Microsoft Graph を使用する AADUser テーブル関数。 AADUser 仮想テーブルを表示して使用するには、組織内のユーザーに Graph アクセス許可を割り当てる必要があります。
操作を許可済み
AADUser 仮想テーブルでは、読み取り操作と読み取り複数操作のみを実行できます。
AADUser テーブル Web API の例
このセクションには、AADUser テーブルからデータにアクセスするための HTTPGET 例が含まれています。
データの取得
AADUser テーブルからデータを取得する例を次に示します。
すべての AADUser テーブル行を取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers
姓 'admin' の AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=surname eq 'admin'
姓 'admin' または 'admin02' の AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=(surname eq 'Admin02') or (surname eq 'Admin')
会社名が null ではない AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=companyname ne null
usertype が 'Member' である AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=usertype eq 'Member'
ビジネスフォン番号に '123-555-1212' が含まれている AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=contains(businessphones, '123-555-1212')
指定した名前が 'test' で始まる AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=startswith(givenname, 'test')
指定された名前が 'test' で始まらない AADUser レコードを取得する
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=not startswith(givenname, 'test')
AADUser レコードを参照する関連アカウント レコードを取得する
以下 new_aaduser_account は、AADUser と Account エンティティの間の 1:N リレーションシップの名前です。
https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers(<user ID>)?$expand=new_aaduser_account($select=accountid,name)
AADUser 行を参照する
次の例では、AADUser テーブル行の参照を示します。
AADUser 行を参照するルックアップ フィールドの値を設定する
この例では、 new_testaaduserId は、AADUser と Account エンティティの間にカスタムの 1:N リレーションシップを使用して作成された単一値ナビゲーション プロパティです。 このナビゲーション プロパティの名前は、リレーションシップの OneToManyRelationshipMetadata.ReferencingEntityNavigationPropertyName プロパティで定義されています。 詳細情報: 単一値ナビゲーション プロパティ
PATCH
https://[Organization URI].crm.dynamics.com/api/data/v9.0/accounts(<account ID>)
{
new_testaaduserId@odata.bind : "/aadusers(user ID)"
}
こちらも参照ください
aaduser テーブル/エンティティ参照
aaduser EntityType リファレンス
セキュリティとデータ アクセス