Partager via

Add-LocalGroupMember

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

Ajoute des membres à un groupe local.

Syntaxe

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

Description

L’applet Add-LocalGroupMember de commande ajoute des utilisateurs ou des groupes à un groupe de sécurité local. Tous les droits et autorisations attribués à un groupe sont attribués à tous les membres de ce groupe.

Les membres du groupe Administrateurs sur un ordinateur local disposent d’autorisations Contrôle total sur cet ordinateur. Limitez le nombre d’utilisateurs dans le groupe Administrateurs.

Si l’ordinateur est joint à un domaine, vous pouvez ajouter des comptes d’utilisateur, des comptes d’ordinateur et des comptes de groupe de ce domaine et des domaines approuvés à un groupe local.

Remarque

Si l’ordinateur est joint à un domaine et que vous essayez d’ajouter un utilisateur local portant le même nom qu’un membre du domaine, il ajoute le membre du domaine.

Exemples

Exemple 1 : Ajouter des membres au groupe Administrateurs

Cette commande ajoute plusieurs membres au groupe Administrateurs local. Les nouveaux membres 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.

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

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é auquel cette applet de commande ajoute des 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 ajoute à un groupe de sécurité. Vous pouvez spécifier des utilisateurs ou des groupes par nom, ID de sécurité (SID) ou objets LocalPrincipal .

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é auquel cette applet de commande ajoute des 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é auquel cette applet de commande ajoute des 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.LocalGroup

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 Add-LocalGroupMember:

  • algm

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

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.