Partager via

Remove-LocalGroupMember

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

Supprime les membres d’un groupe local.

Syntaxe

Remove-LocalGroupMember
      [-Group] <LocalGroup>
      [-Member] <LocalPrincipal[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-LocalGroupMember
      [-Member] <LocalPrincipal[]>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet Remove-LocalGroupMember de commande supprime des utilisateurs ou des groupes d’un groupe local.

Remarque

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

Exemples

Exemple 1 : Supprimer des membres du groupe Administrateurs

$members = "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
Remove-LocalGroupMember -Group "Administrators" -Member $members

Cette commande supprime plusieurs membres du groupe Administrateurs local. Les membres supprimés par cette applet de commande incluent un compte d’utilisateur local, un compte Microsoft, un compte Microsoft Entra et un groupe de domaines. Cet exemple utilise une valeur d’espace réservé pour le nom d’utilisateur d’un compte à Outlook.com.

Paramètres

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Group

Spécifie le groupe de sécurité à partir duquel cette applet de commande supprime les membres.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Member

Spécifie un tableau d’utilisateurs ou de groupes que cette applet de commande supprime d’un groupe de sécurité. Vous pouvez spécifier des utilisateurs ou des groupes par nom, ID de sécurité (SID) ou objets LocalPrincipal . Spécifiez des chaînes SID dans S-R-I-S-S . . . format.

Type:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du groupe de sécurité à partir duquel cette applet de commande supprime les membres.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SID

Spécifie l’ID de sécurité du groupe de sécurité à partir duquel cette applet de commande supprime les membres.

Type:SecurityIdentifier
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.Management.Automation.SecurityAccountsManager.LocalPrincipal

Vous pouvez diriger un principal local 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-LocalGroupMember:

  • rlgm

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.