Remove-LocalGroup
Supprime les groupes de sécurité locaux.
Syntaxe
InputObject
Remove-LocalGroup
[-InputObject] <LocalGroup[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Remove-LocalGroup
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Remove-LocalGroup
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Remove-LocalGroup 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 invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 commande Get-LocalGroup.
Propriétés du paramètre
| Type: | Microsoft.PowerShell.Commands.LocalGroup[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
InputObject
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie un tableau de noms des groupes de sécurité que cette applet de commande supprime.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-SID
Spécifie un tableau d’ID de sécurité (SID) de groupes de sécurité que cette applet de commande supprime.
Propriétés du paramètre
| Type: | |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
SecurityIdentifier
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| 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.
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 aucune 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 du journal des é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 avancés
- Utilisateurs de bureau à distance
- Utilisateurs de gestion à distance
- Replicator
- Utilisateurs
- WinRMRemoteWMIUsers__
La propriété PrincipalSource est une propriété des objets LocalUser, LocalGroupet LocalPrincipal qui décrit 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.
