Freigeben über


Azure Active Directory-Benutzertabelle

Hinweis

Azure Active Directory ist jetzt Microsoft Entra ID. Weitere Informationen

Microsoft Dataverse enthält eine virtuelle Tabelle mit dem Namen AAD-Benutzer (aaduser). Diese virtuelle Tabelle stellt eine Verbindung mit Azure Active Directory (AAD) bereit und gibt Daten zu Benutzern innerhalb Ihrer AAD-Organisation zurück. Für die Verwendung der Funktionalität ist keine Konfiguration für virtuelle Tabellen erforderlich. Dies ist ein Nur-Online-Feature.

Hinweis

Ihre Ergebnisse mit AAD-Benutzer können je nach Verwendungszweck unterschiedlich sein. AAD-Benutzer in Dataverse stellt die vollständige Liste der Benutzer in Azure AD für die Organisation bereit. AAD-Benutzer in Dataverse for Teams beschränkt sich auf die Bereitstellung aller AAD-Benutzer, die auch Mitglied des Teams sind.

AAD-Benutzer gibt keine Gruppen oder Verteilerlisten zurück.

Abfragen unter Verwendung von AADUser

Sie können dieser virtuellen Tabelle im Power Apps-Portal einfach eine Nachschlagefunktion hinzufügen.

Erstellen Sie eine Suchspalte mit einer verknüpften Tabelle von AADUser

Erlaubnisse

Die AADUser-Tabellenfunktionen verwenden Microsoft Graph. Benutzern in Ihrer Organisation müssen Graph-Berechtigungen zugewiesen werden, um die virtuelle AADUser-Tabelle anzuzeigen und zu verwenden.

Zulässige Vorgänge

Nur Lese- und Mehrfachlesevorgänge sind über die virtuelle AADUser-Tabelle möglich.

Beispiele für AADUser-Tabellenweb-API

Dieser Abschnitt enthält HTTPGET Beispiele für den Zugriff auf Daten aus der AADUser-Tabelle.

Abrufen von Daten

Das folgende Beispiel veranschaulicht das Abrufen von Daten aus der AADUser-Tabelle.

Abrufen aller AADUser-Tabellenzeilen

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers  

Abrufen von AADUser-Datensätzen mit dem Nachnamen "admin"

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

Abrufen von AADUser-Einträgen mit dem Nachnamen "admin" oder "admin02"

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers?$filter=(surname eq 'Admin02') or (surname eq 'Admin')

Abrufen von AADUser-Datensätzen, deren Firmenname nicht NULL ist

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

Abrufen von AADUser-Datensätzen, deren Benutzertyp "Member" ist

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

AADUser-Datensätze abrufen, deren Geschäftstelefone "123-555-1212" enthalten

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

Abrufen von AADUser-Datensätzen, deren Vorname mit "test" beginnt

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

Abrufen von AADUser-Datensätzen, deren Vorname NICHT mit "test" beginnt

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

Abrufen verwandter Kontodatensätze, die auf einen AADUser-Eintrag verweisen

Unten ist new_aaduser_account der Name der 1:N-Beziehung zwischen AADUser und der Firmenentität.

https://[Organization URI].crm.dynamics.com/api/data/v9.1/aadusers(<user ID>)?$expand=new_aaduser_account($select=accountid,name)

Verweisen auf eine AADUser-Zeile

Das folgende Beispiel veranschaulicht das Verweisen auf eine AADUser-Tabellenzeile.

Wert für Nachschlagefeld festlegen, das auf eine AADUser-Zeile verweist

In diesem Beispiel new_testaaduserId handelt es sich um die einzelwertige Navigationseigenschaft, die mit einer benutzerdefinierten 1:N-Beziehung zwischen AADUser und Account-Entität erstellt wurde. Der Name dieser Navigationseigenschaft wird in der OneToManyRelationshipMetadata.ReferencingEntityNavigationPropertyName-Eigenschaft der Beziehung definiert. Weitere Informationen: Einzelwert-Navigationseigenschaften

PATCH
https://[Organization URI].crm.dynamics.com/api/data/v9.0/accounts(<account ID>)
{
  new_testaaduserId@odata.bind : "/aadusers(user ID)"
}

Siehe auch

aaduser Tabelle/Entitätsreferenz
aaduser EntityType-Referenz
Sicherheit und Datenzugriff