Remove-LocalGroup

  • Référence
Module:
Microsoft.PowerShell.LocalAccounts

Supprime les groupes de sécurité locaux.

Syntax

Remove-LocalGroup
      [-InputObject] <LocalGroup[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-Name] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroup
      [-SID] <SecurityIdentifier[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet Remove-LocalGroup de commande supprime les groupes de sécurité locaux. Cette applet de commande supprime uniquement un groupe local. Il ne supprime pas les comptes d’utilisateur, les comptes d’ordinateur ou les comptes de groupe qui appartiennent à ce groupe. Vous ne pouvez pas récupérer un groupe supprimé.

Si vous supprimez un groupe, puis créez un autre groupe portant le même nom de groupe, vous devez définir de nouvelles autorisations pour le nouveau groupe. Le nouveau groupe n’hérite pas des autorisations qui ont été affectées au groupe.

Remarque

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Supprimer un groupe de sécurité

Remove-LocalGroup -Name "SecurityGroup04"

Cette commande supprime le groupe nommé SecurityGroup04.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Spécifie un tableau de groupes de sécurité que cette applet de commande supprime. Pour obtenir des groupes, utilisez l’applet de Get-LocalGroup commande.

Type:Microsoft.PowerShell.Commands.LocalGroup[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie un tableau de noms des groupes de sécurité que cette applet de commande supprime.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SID

Spécifie un tableau d’ID de sécurité (SID) de groupes de sécurité que cette applet de commande supprime.

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

System.Management.Automation.SecurityAccountsManager.LocalGroup

Vous pouvez diriger un groupe de sécurité vers cette applet de commande.

String

Vous pouvez diriger une chaîne vers cette applet de commande.

SecurityIdentifier

Vous pouvez diriger un SID vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Remove-LocalGroup:

  • rlg

Cette applet de commande ne peut pas supprimer les groupes par défaut suivants :

  • Administrateurs
  • Opérateurs de sauvegarde
  • Opérateurs de chiffrement
  • Utilisateurs du modèle COM distribué
  • Lecteurs des journaux d’événements
  • Invités
  • Administrateurs Hyper-V
  • IIS_IUSRS
  • Opérateurs de configuration réseau
  • Utilisateurs du journal des performances
  • Utilisateurs de l’Analyseur de performances
  • Utilisateurs avec pouvoir
  • Utilisateurs du Bureau à distance
  • Utilisateurs de gestion à distance
  • Duplicateur
  • Utilisateurs
  • WinRMRemoteWMIUsers__

La propriété PrincipalSource est une propriété sur les objets LocalUser, LocalGroup et LocalPrincipal qui décrivent la source de l’objet. Les sources possibles sont les suivantes :

  • Local
  • Active Directory
  • Groupe Microsoft Entra
  • Compte Microsoft

PrincipalSource est pris en charge uniquement par Windows 10, Windows Server 2016 et versions ultérieures du système d’exploitation Windows. Pour les versions antérieures, la propriété est vide.