Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Remova um proprietário de um grupo do Microsoft 365 ou de um grupo de segurança através da propriedade de navegação dos proprietários . Depois de os proprietários serem atribuídos a um grupo, o último proprietário (um objeto de utilizador) do grupo não pode ser removido.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Group.ReadWrite.All | Directory.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Group.ReadWrite.All | Directory.ReadWrite.All |
Em cenários delegados, o utilizador com sessão iniciada também tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com a permissão de função necessária. As seguintes funções com menos privilégios são suportadas para esta operação:
| Microsoft Entra função | Limitações | Permissão de função-chave |
|---|---|---|
| Proprietários de grupos | Pode modificar todos os tipos de proprietários de grupos | microsoft.directory/groups/owners/update |
| Administrador do usuário | Só é possível modificar proprietários de utilizadores | microsoft.directory/groups/owners/update |
| Escritores de diretório | Só é possível modificar proprietários de utilizadores | microsoft.directory/groups/owners/update |
| Administrador de Grupos | Pode modificar todos os tipos de proprietários de grupos | microsoft.directory/groups/owners/update |
| Administrador do Exchange | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
| Administrador do SharePoint | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
| Administrador do Teams | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
| Administrador do Yammer | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
| Administrador do Intune | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
| Administrador de Conhecimento | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
| Gerente de Conhecimento | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
| Administrador do Windows 365 | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
Solicitação HTTP
DELETE /groups/{id}/owners/{id}/$ref
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se bem sucedido, este método retorna um código de resposta 204 No Content. Não devolve nada no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
DELETE https://graph.microsoft.com/v1.0/groups/{id}/owners/{id}/$ref
Na solicitação, especifique a id do objeto diretório que deseja remover após o segmento $ref.
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 204 No Content