Remove-EntraGroup

Módulo:
Microsoft.Entra.Groups Module v1.3

Remove um grupo.

Sintaxe

Default (Predefinição) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Descrição

O Remove-EntraGroup cmdlet remove um grupo do Microsoft Entra ID. Especificar que o GroupId parâmetro remove um grupo.

O Grupo Unificado pode ser restaurado dentro de 30 dias após a eliminação usando o Restore-EntraBetaDeletedDirectoryObject cmdlet. Os grupos de segurança não podem ser restaurados após a eliminação.

Notas sobre permissões:

As seguintes condições aplicam-se para que as aplicações eliminem grupos atribuídos por funções:

  • Para cenários delegados, a aplicação deve receber a RoleManagement.ReadWrite.Directory permissão delegada, e o utilizador que chama deve ser o criador do grupo ou ter pelo menos o papel de Administrador de Papéis Privilegiados Microsoft Entra.
  • Para cenários apenas de aplicação, a aplicação que chama deve ser a proprietária do grupo, ter a RoleManagement.ReadWrite.Directory permissão atribuída à aplicação ou pelo menos o papel de Administrador de Papéis Privilegiados Microsoft Entra.

Exemplos

Exemplo 1: Remover um grupo

Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Remove-EntraGroup -GroupId $group.Id

Este exemplo demonstra como remover um grupo no Microsoft Entra ID.

  • GroupId parâmetro especifica o ID do grupo .

Exemplo 2: Remover um grupo usando pipeline

Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'" | Remove-EntraGroup

Este exemplo demonstra como remover um grupo no Microsoft Entra ID.

Parâmetros

-GroupId

Especifica o ID de objeto de um grupo no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.