Remove-EntraGroup

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

Remove um grupo.

Sintaxe

Default (Default) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Description

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

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

Anotações sobre permissões:

As seguintes condições aplicam-se às aplicações para eliminar grupos atribuíveis a funções:

  • Para cenários delegados, o aplicativo deve receber a RoleManagement.ReadWrite.Directory permissão delegada e o usuário de chamada deve ser o criador do grupo ou receber pelo menos a função administrador de função com privilégios Microsoft Entra função.
  • Para cenários somente de aplicativo, o aplicativo de chamada deve ser o proprietário do grupo ou receber a permissão do RoleManagement.ReadWrite.Directory aplicativo ou receber pelo menos a função Microsoft Entra administrador de função com privilégios.

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 em Microsoft Entra ID.

  • GroupId o parâmetro especifica a ID do grupo.

Exemplo 2: remover um grupo usando pipelining

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

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

Parâmetros

-GroupId

Especifica a ID de objeto de um grupo em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.