List servicePrincipal transitive memberOf

2025-02-22

Namespace: microsoft.graph

Gruppen und Verzeichnisrollen aufrufen, in denen dieser Dienstprinzipal ein Mitglied ist. Dieser Vorgang ist transitiv und schließt alle Gruppen ein, in denen dieser Dienstprinzipal ein geschachteltes Mitglied.

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

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

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.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Application.Read.All	Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	Application.Read.All	Application.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.*Erlaubnisse. Einzelheiten finden Sie unter Eingeschränkte Informationen, die für nicht zugängliche Mitgliedsobjekte zurückgegeben werden.

HTTP-Anforderung

Sie können den Dienstprinzipal entweder mit seiner ID oder appId adressieren. id und appId werden in App-Registrierungen im Microsoft Entra Admin Center als Objekt-ID bzw. Anwendungs-ID (Client-ID) bezeichnet.

GET /servicePrincipals/{id}/transitiveMemberOf
GET /servicePrincipals(appId='{appId}')/transitiveMemberOf

Optionale Abfrageparameter

Diese Methode unterstützt die $filterOData-Abfrageparameter , $count$select, $search$top um die Antwort anzupassen.

Die OData-Umwandlung ist ebenfalls aktiviert.
$search wird nur für die Eigenschaften displayName und description unterstützt.
Die Standard- und maximale Seitengröße beträgt 100 bzw. 999 Objekte.
Die Verwendung von Abfrageparametern mit dieser API wird nur bei erweiterten Abfrageparametern unterstützt. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
ConsistencyLevel	schließlich. Diese Kopfzeile und `$count` sind bei Verwendung der Abfrageparameter `$search`, `$filter`, `$orderby` oder OData-Cast erforderlich. Es wird ein Index verwendet, der möglicherweise nicht auf dem neuesten Stand der jüngsten Änderungen am Objekt ist.

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

Beispiel 1: Gruppen und Verzeichnisrollen aufrufen, in denen der Dienstprinzipal ein transitives Mitglied ist.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/servicePrincipals/00063ffc-54e9-405d-b8f3-56124728e051/transitiveMemberOf


// 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.ServicePrincipals["{servicePrincipal-id}"].TransitiveMemberOf.GetAsync();



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

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


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
transitiveMemberOf, err := graphClient.ServicePrincipals().ByServicePrincipalId("servicePrincipal-id").TransitiveMemberOf().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.servicePrincipals().byServicePrincipalId("{servicePrincipal-id}").transitiveMemberOf().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let transitiveMemberOf = await client.api('/servicePrincipals/00063ffc-54e9-405d-b8f3-56124728e051/transitiveMemberOf')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


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


$result = $graphServiceClient->servicePrincipals()->byServicePrincipalId('servicePrincipal-id')->transitiveMemberOf()->get()->wait();


Import-Module Microsoft.Graph.Applications

Get-MgServicePrincipalTransitiveMemberOf -ServicePrincipalId $servicePrincipalId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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.service_principals.by_service_principal_id('servicePrincipal-id').transitive_member_of.get()

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "id-value",
      "createdDateTime": null,
      "description": "All users at the company",
      "displayName": "All Users",
      "groupTypes": [],
      "mailEnabled": false,
      "securityEnabled": true,
    }
  ]
}

Beispiel 2: Abrufen der Anzahl der lediglich transitiven Mitgliedschaften

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/transitiveMemberOf/$count
ConsistencyLevel: eventual

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-type: text/plain

294

Beispiel 3: OData-Besetzung verwenden, um nur die Anzahl transitiven Mitgliedschaften in Gruppen zu erhalten

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/transitiveMemberOf/microsoft.graph.group/$count
ConsistencyLevel: eventual

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-type: text/plain

294

Beispiel 4: $search und OData-Cast verwenden, um Gruppenmitgliedschaften mit Anzeigenamen zu erhalten, die "Video" enthalten, einschließlich einer Zählung der zurückgegebenen Objekte

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/transitiveMemberOf/microsoft.graph.group?$count=true&$orderby=displayName&$search="displayName:Video"&$select=displayName,id
ConsistencyLevel: eventual

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups(displayName,id)",
  "@odata.count":7,
  "value":[
    {
      "displayName":"Contoso Videos",
      "id":"11111111-2222-3333-4444-555555555555"
    }
  ]
}

Beispiel 5: $filter und OData-Cast verwenden, um Gruppenmitgliedschaft mit einem Anzeigenamen zu erhalten, der mit 'A' beginnt, einschließlich einer Zählung der zurückgegebenen Objekte

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/servicePrincipals/{id}/transitiveMemberOf/microsoft.graph.group?$count=true&$orderby=displayName&$filter=startswith(displayName, 'a')
ConsistencyLevel: eventual

Antwort

Das folgende Beispiel zeigt die Antwort.

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups",
  "@odata.count":76,
  "value":[
    {
      "displayName":"AAD Contoso Users",
      "mail":"AADContoso_Users@contoso.com",
      "mailEnabled":true,
      "mailNickname":"AADContoso_Users",
      "securityEnabled":true
    }
  ]
}

Freigeben über

List servicePrincipal transitive memberOf

Berechtigungen

HTTP-Anforderung

Optionale Abfrageparameter

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Gruppen und Verzeichnisrollen aufrufen, in denen der Dienstprinzipal ein transitives Mitglied ist.

Anforderung

Antwort

Beispiel 2: Abrufen der Anzahl der lediglich transitiven Mitgliedschaften

Anforderung

Antwort

Beispiel 3: OData-Besetzung verwenden, um nur die Anzahl transitiven Mitgliedschaften in Gruppen zu erhalten

Anforderung

Antwort

Beispiel 4: $search und OData-Cast verwenden, um Gruppenmitgliedschaften mit Anzeigenamen zu erhalten, die "Video" enthalten, einschließlich einer Zählung der zurückgegebenen Objekte

Anforderung

Antwort

Beispiel 5: $filter und OData-Cast verwenden, um Gruppenmitgliedschaft mit einem Anzeigenamen zu erhalten, der mit 'A' beginnt, einschließlich einer Zählung der zurückgegebenen Objekte

Anforderung

Antwort

Feedback

Zusätzliche Ressourcen