Agent auflistenDirekte Mitgliedschaften für Benutzer

Namespace: microsoft.graph

Rufen Sie Gruppen, Verzeichnisrollen und Verwaltungseinheiten ab, in denen der agentUser ein direktes Mitglied ist. Dieser Vorgang ist nicht transitiv.

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

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

HTTP-Anforderung

GET /users/{usersId}/memberOf

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort, einschließlich $search, $count und $filter. Die OData-Umwandlung ist ebenfalls aktiviert. Beispielsweise können Sie diese Datei umwandeln, um nur die directoryRoles abzurufen, in denen der Benutzer Mitglied ist. Sie können $search auf die Eigenschaft displayName verwenden. Elemente, die für diese Ressource hinzugefügt oder aktualisiert werden, werden speziell für die Verwendung mit den $count Abfrageparametern und $search indiziert. Zwischen dem Hinzufügen oder Aktualisieren eines Elements und der Verfügbarkeit im Index kann es zu einer leichten Verzögerung kommen.

Die Verwendung mit $filter dieser API erfordert, dass der ConsistencyLevel-Header auf und $countgesetzt isteventual. In solchen Szenarien können Sie jedoch nicht dieselbe Anforderung verwenden $expand , da sie von erweiterten Abfrageparametern nicht unterstützt wird. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Anforderungsheader

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine Sammlung von directoryObject-Objekten im Antworttext zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/beta/users/{usersId}/memberOf

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].MemberOf.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
memberOf, err := graphClient.Users().ByUserId("user-id").MemberOf().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

DirectoryObjectCollectionResponse result = graphClient.users().byUserId("{user-id}").memberOf().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let memberOf = await client.api('/users/{usersId}/memberOf')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->users()->byUserId('user-id')->memberOf()->get()->wait();

Import-Module Microsoft.Graph.Beta.Users

Get-MgBetaUserMemberOf -UserId $userId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.users.by_user_id('user-id').member_of.get()

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.directoryObject",
      "id": "a6c034b8-621b-dee3-6abb-52cbce801fe9",
    }
  ]
}