Partager via

Add-LocalGroupMember

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

Ajoute des membres à un groupe local.

Syntax

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 Administration istrators sur un ordinateur local disposent d’autorisations Contrôle total sur cet ordinateur. Limitez le nombre d’utilisateurs dans le groupe Administration istrators.

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 Administration istrators

Cette commande ajoute plusieurs membres au groupe Administration istrators 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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

Spécifie le groupe de sécurité auquel cette applet de commande ajoute des membres.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie le nom du groupe de sécurité auquel cette applet de commande ajoute des membres.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
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 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.