Enumerar memberOf transitivos de grupo

Espacio de nombres: microsoft.graph

Obtener los grupos de los que es miembro el grupo . Esta operación es transitiva y también incluirá todos los grupos de los que este grupo es miembro anidado. A diferencia de obtener los grupos de Microsoft 365 de un usuario, esto devuelve todos los tipos de grupos, no solo los grupos de Microsoft 365.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global	Administración pública de EE. UU.	Gobierno de EE. UU. L5 (DOD)	China operado por 21Vianet
✅	✅	✅	✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	GroupMember.ReadBasic.All	Directory.Read.All, Directory.ReadWrite.All, Group.Read.All, Group.ReadBasic.All, GroupMember.Read.All
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	GroupMember.ReadBasic.All	Directory.Read.All, Directory.ReadWrite.All, Group.ReadBasic.All

Importante

Cuando una aplicación consulta una relación que devuelve una colección de tipos directoryObject , si no tiene permiso para leer un tipo de recurso determinado, se devuelven miembros de ese tipo, pero con información limitada. Por ejemplo, solo se devuelve la propiedad @odata.type para el tipo de objeto y el id ., mientras que las demás propiedades se indican como null. Con este comportamiento, las aplicaciones pueden solicitar los permisos con privilegios mínimos que necesitan, en lugar de depender del conjunto de directorios.* permisos. Para información, consulte Información limitada devuelta para objetos de miembros inaccesibles.

Solicitud HTTP

GET /groups/{id}/transitiveMemberOf

Parámetros de consulta opcionales

Este método admite los parámetros de $countconsulta , $expand, $filter, $orderby$search, $selecty $topOData para ayudar a personalizar la respuesta.

La conversión de OData está habilitada. Por ejemplo, /groups/{id}/transitiveMemberOf/microsoft.graph.group recupera solo los grupos de los que es miembro, ya sea directa o indirectamente.
$search solo se admite en las propiedades displayName y description .
El tamaño de página predeterminado y máximo es 100 y 999 objetos de grupo respectivamente.
El uso de parámetros de consulta con esta API, excepto $expand, solo se admite con parámetros de consulta avanzados. $expand no se admite con parámetros de consulta avanzados. Para obtener más información, vea Funcionalidades avanzadas de consulta en objetos de directorio.

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
ConsistencyLevel	eventual. Este encabezado y `$count` son requeridos al usar los parámetros de consulta `$search`, `$filter`, `$orderby` u OData. Usa un índice que podría no estar actualizado con los cambios recientes realizados en el objeto.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y la colección de objetos directoryObject en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Obtener los grupos y unidades administrativas de los que el grupo es miembro transitivo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/v1.0/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/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.Groups["{group-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.Groups().ByGroupId("group-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.groups().byGroupId("{group-id}").transitiveMemberOf().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let transitiveMemberOf = await client.api('/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/transitiveMemberOf')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


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


$result = $graphServiceClient->groups()->byGroupId('group-id')->transitiveMemberOf()->get()->wait();


Import-Module Microsoft.Graph.Groups

Get-MgGroupTransitiveMemberOf -GroupId $groupId


# 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.groups.by_group_id('group-id').transitive_member_of.get()

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.group",
      "id": "11111111-2222-3333-4444-555555555555",
      "mail": "group1@contoso.com"
    }
  ]
}

Ejemplo 2: Obtener solo un recuento de toda la pertenencia transitiva

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

294

Ejemplo 3: Usar la conversión de OData para obtener solo un recuento de la pertenencia transitiva en grupos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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

294

Ejemplo 4: Usar OData cast y $search para obtener la pertenencia a grupos con nombres para mostrar que contienen las letras "tier", incluido un recuento de objetos devueltos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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-tier Query Notification",
      "id":"11111111-2222-3333-4444-555555555555"
    }
  ]
}

Ejemplo 5: Usar OData cast y $filter para obtener la pertenencia con un nombre para mostrar que empiece por "A", incluido un recuento de objetos devueltos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

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"
    }
  ]
}

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-08-13

Enumerar memberOf transitivos de grupo

Permissions

Solicitud HTTP

Parámetros de consulta opcionales

Encabezados de solicitud

Cuerpo de la solicitud

Respuesta

Ejemplos

Ejemplo 1: Obtener los grupos y unidades administrativas de los que el grupo es miembro transitivo

Solicitud

Respuesta

Ejemplo 2: Obtener solo un recuento de toda la pertenencia transitiva

Solicitud

Respuesta

Ejemplo 3: Usar la conversión de OData para obtener solo un recuento de la pertenencia transitiva en grupos

Solicitud

Respuesta

Ejemplo 4: Usar OData cast y $search para obtener la pertenencia a grupos con nombres para mostrar que contienen las letras "tier", incluido un recuento de objetos devueltos

Solicitud

Respuesta

Ejemplo 5: Usar OData cast y $filter para obtener la pertenencia con un nombre para mostrar que empiece por "A", incluido un recuento de objetos devueltos

Solicitud

Respuesta

Comentarios

Recursos adicionales