Add-LocalGroupMember
Ajoute des membres à un groupe local.
Syntaxe
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Add-LocalGroupMember 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 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 |
-Group
Spécifie le groupe de sécurité auquel cette applet de commande ajoute des membres.
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
Group
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom du groupe de sécurité auquel cette applet de commande ajoute des membres.
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: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SID
Spécifie l’ID de sécurité du groupe de sécurité auquel cette applet de commande ajoute des membres.
Propriétés du paramètre
| Type: | SecurityIdentifier |
| 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: | False |
| Valeur du pipeline par nom de propriété: | False |
| 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 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 aucune 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é 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.
