Mitglieder auflisten

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Verwenden Sie diese API, um die Mitgliederliste (Benutzer, Gruppen und Geräte) in einer Verwaltungseinheit abzurufen.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	AdministrativeUnit.Read.All	AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	AdministrativeUnit.Read.All	AdministrativeUnit.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All

Wichtig

Wenn eine Anwendung eine Beziehung abfragt, die eine directoryObject-Typauflistung zurückgibt, wenn sie nicht über die Berechtigung zum Lesen eines bestimmten Ressourcentyps verfügt, werden Member dieses Typs zurückgegeben, aber mit eingeschränkten Informationen. Beispielsweise wird nur die @odata.type-Eigenschaft für den Objekttyp und die ID zurückgegeben, während andere Eigenschaften als nullangegeben werden. Mit diesem Verhalten können Anwendungen die am wenigsten privilegierten Berechtigungen anfordern, die sie benötigen, anstatt sich auf den Satz von Verzeichnis zu verlassen.*Berechtigungen. Einzelheiten finden Sie unter Eingeschränkte Informationen, die für nicht zugängliche Mitgliedsobjekte zurückgegeben werden.

Hinweis

Um die Mitglieder mit einer ausgeblendeten Mitgliedschaft in einer Verwaltungseinheit anzuzeigen, muss der App die delegierte Berechtigung Member.Read.Hidden oder die Anwendungsberechtigung erteilt werden.

In delegierten Szenarien muss der angemeldete Benutzer mitglied sein oder einer unterstützten Microsoft Entra-Rolle oder einer benutzerdefinierten Rolle mit einer unterstützten Rollenberechtigung zugewiesen sein. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

Microsoft Entra-Rolle	Begrenzungen	Schlüsselrollenberechtigung
Verzeichnisleser	Lesen grundlegender Eigenschaften für Verwaltungseinheiten	microsoft.directory/administrativeUnits/standard/read
Verzeichnisleser	Lesen von Mitgliedern von Verwaltungseinheiten	microsoft.directory/administrativeUnits/members/read
Globaler Leser	Lesen aller Eigenschaften von Verwaltungseinheiten, einschließlich Mitgliedern	microsoft.directory/administrativeUnits/allProperties/read
Administrator für privilegierte Rollen	Erstellen und Verwalten von Verwaltungseinheiten (einschließlich Mitgliedern)	microsoft.directory/administrativeUnits/allProperties/allTasks

HTTP-Anforderung

GET /administrativeUnits/{id}/members
GET /administrativeUnits/{id}/members/$ref

Optionale Abfrageparameter

Diese Methode (bei Verwendung ohne $ref) unterstützt die OData-Abfrageparameter , um die Antwort anzupassen, einschließlich $search, $countund $filter. Die OData-Umwandlung ist ebenfalls aktiviert. Sie können z. B. eine Umwandlung ausführen, um nur die Benutzer abzurufen, die Mitglied der Verwaltungseinheit sind.

$search wird nur für die Eigenschaften displayName und description unterstützt. Einige Abfragen werden nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
ConsistencyLevel	schließlich. Diese Kopfzeile und $count sind erforderlich, wenn $search verwendet wird oder wenn $filter verwendet wird. Weitere Informationen zur Verwendung von ConsistencyLevel und $countfinden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und eine Sammlung von Benutzer-, Gruppen- oder Geräteobjekten im Antworttext zurück. Das Hinzufügen $ref am Ende der Anforderung gibt nur @odata.id eine Auflistung von URLs der Member zurück.

Beispiele

Beispiel 1: Auflisten von Memberobjekten

Anforderung

Die folgende Anforderung listet die Mitglieder der Verwaltungseinheit auf und gibt eine Sammlung von Benutzern und/oder Gruppen zurück.

GET https://graph.microsoft.com/beta/administrativeUnits/{id}/members

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value":[
    {
      "@odata.type":"#microsoft.graph.user",
      "id":"492c5308-59fd-4740-9c83-4b3db07a6d70"
      "accountEnabled":true,
      "businessPhones":[],
      "companyName":null,
      "displayName":"Demo User"
    },
    {
      "@odata.type":"#microsoft.graph.group",
      "id":"07eaa5c7-c9b6-45cf-8ff7-3147d5122caa",
      "description":"This group is the best ever",
      "displayName":"Awesome group"
    }
  ]
}

Beispiel 2: Memberverweise auflisten

Anforderung

Die folgende Anforderung listet die Memberverweise der Verwaltungseinheit auf und gibt eine Auflistung von @odata.id Verweisen auf die Elemente zurück.

GET https://graph.microsoft.com/beta/administrativeUnits/{id}/members/$ref

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "value":[
    {
      "@odata.id": "https://graph.microsoft.com/beta/directoryObjects/492c5308-59fd-4740-9c83-4b3db07a6d70"
    },
    {
      "@odata.id": "https://graph.microsoft.com/beta/directoryObjects/07eaa5c7-c9b6-45cf-8ff7-3147d5122caa"
    }
  ]
}