Azure Active Directory ユーザー テーブル

注意

現在 Azure Active Directory は Microsoft Entra ID になりました。 詳細

Microsoft Dataverse には AAD ユーザー (aaduser) という名前の仮想テーブルが含まれています。 この仮想テーブルを使用すると、Azure Active Directory (AAD) へ接続することができ、AAD 組織内のユーザーに関するデータを返します。 この機能を使用するために仮想テーブルを構成する必要はありません。 これはオンラインのみの機能です。

注意

AAD User での結果は、使用されている場所によって異なる場合があります。 Dataverse の AAD ユーザーは、組織の Azure AD のユーザーの完全なリストを提供します。 Dataverse for Teams の AAD ユーザーは、チームのメンバーでもあるすべての AAD ユーザーを提供するように制限されています。

AAD ユーザーは、グループまたは配布リストを返しません。

AADUser を使用した検索

Power Apps ポータル内から簡単に検索をこの仮想テーブルに追加できます。

アクセス許可

AADUser テーブルは、Microsoft Graph を使用して機能します。 AADUser 仮想テーブルを表示して使用するには、組織内のユーザーにグラフのアクセス許可を割り当てる必要があります。

操作を許可済み

AADUser 仮想テーブルを介して実行できるのは、読み取り操作および複数の読み取り操作のみです。

AADUser テーブル Web API の例

このセクションには、AADUser テーブルのデータにアクセスするための HTTP GET の例が含まれています。

データの取得

次の例は、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')

companyname が null 値ではない AADUser レコードを取得する

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=companyname ne null

usertype が "メンバー" である AADUser レコードを取得する

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=usertype eq 'Member'

businessphones に "123-555-1212" が含まれている AADUser レコードを取得する

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=contains(businessphones, '123-555-1212')

givenname が "test" で始まる AADUser レコードを取得する

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=startswith(givenname, 'test')

givenname が "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 reference
セキュリティとデータ アクセス

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。