Quitar miembro

Espacio de nombres: microsoft.graph

Quite un miembro de un grupo mediante la propiedad de navegación members . No se puede quitar un miembro de grupos con pertenencias dinámicas.

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

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.

En escenarios delegados, también se debe asignar al usuario que ha iniciado sesión una función de Microsoft Entra compatible o una función personalizada con el permiso de microsoft.directory/groups/members/update función. Se admiten los siguientes roles con privilegios mínimos para esta operación, excepto para los grupos asignables a roles:

• Propietarios de grupos
• Escritores de directorios
• Administrador de grupos
• Administrador de gobernanza de identidades
• Administrador de usuarios
• Administrador de Exchange: solo para grupos de Microsoft 365
• Administrador de SharePoint: solo para grupos de Microsoft 365
• Administrador de Teams: solo para grupos de Microsoft 365
• Administrador de Yammer: solo para grupos de Microsoft 365
• Administrador de Intune: solo para grupos de seguridad

Para quitar miembros de un grupo a el que se puede asignar un rol, se debe asignar también a la aplicación el permiso RoleManagement.ReadWrite.Directory y se debe asignar al usuario que llama un rol compatible de Microsoft Entra. El administrador de roles con privilegios es el rol con privilegios mínimos que se admite para esta operación.

Solicitud HTTP

DELETE /groups/{id}/members/{id}/$ref

Encabezados de solicitud

Cuerpo de la solicitud

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

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

DELETE https://graph.microsoft.com/beta/groups/{group-id}/members/{directory-object-id}/$ref

// 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
await graphClient.Groups["{group-id}"].Members["{directoryObject-id}"].Ref.DeleteAsync();

// 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
graphClient.Groups().ByGroupId("group-id").Members().ByDirectoryObjectId("directoryObject-id").Ref().Delete(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.groups().byGroupId("{group-id}").members().byDirectoryObjectId("{directoryObject-id}").ref().delete();

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/groups/{group-id}/members/{directory-object-id}/$ref')
	.version('beta')
	.delete();

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


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


$graphServiceClient->groups()->byGroupId('group-id')->members()->byDirectoryObjectId('directoryObject-id')->ref()->delete()->wait();

Import-Module Microsoft.Graph.Beta.Groups

Remove-MgBetaGroupMemberDirectoryObjectByRef -GroupId $groupId -DirectoryObjectId $directoryObjectId

# 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

await graph_client.groups.by_group_id('group-id').members.by_directory_object_id('directoryObject-id').ref.delete()

En la solicitud, especifique el identificador del grupo y el identificador del objeto de directorio que quiere quitar.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 204 No Content

Contenido relacionado

• Agregar un miembro al equipo
• Actualizar el rol del miembro en el equipo
• Quitar miembro de un equipo