Remove-EntraGroup

Module:
Microsoft.Entra.Groups Module v1.3

Supprime un groupe.

Syntaxe

Default (Par défaut) 

Remove-EntraGroup

    -GroupId <String>
    [<CommonParameters>]

Description

L’applet Remove-EntraGroup de commande supprime un groupe de Microsoft Entra ID. Spécifiez le GroupId paramètre qui supprime un groupe.

Le groupe unifié peut être restauré avec 30 jours après la suppression à l’aide de l’applet de Restore-EntraBetaDeletedDirectoryObject commande. Les groupes de sécurité ne peuvent pas être restaurés après la suppression.

Remarques sur les autorisations :

Les conditions suivantes s’appliquent pour que les applications suppriment des groupes assignables à un rôle :

  • Pour les scénarios délégués, l’application doit être affectée à l’autorisation RoleManagement.ReadWrite.Directory déléguée, et l’utilisateur appelant doit être le créateur du groupe ou au moins le rôle Administrateur de rôle privilégié Microsoft Entra.
  • Pour les scénarios d’application uniquement, l’application appelante doit être propriétaire du groupe ou attribuer l’autorisation RoleManagement.ReadWrite.Directory d’application ou être affectée au moins au rôle Administrateur de rôle privilégié Microsoft Entra.

Exemples

Exemple 1 : Supprimer un groupe

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

Cet exemple montre comment supprimer un groupe dans Microsoft Entra ID.

  • GroupId spécifie l’ID de groupe .

Exemple 2 : Supprimer un groupe à l’aide du pipelining

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

Cet exemple montre comment supprimer un groupe dans Microsoft Entra ID.

Paramètres

-GroupId

Spécifie l’ID d’objet d’un groupe dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId)

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.