Set-LocalGroup
Modifie un groupe de sécurité local.
Syntaxe
InputObject
Set-LocalGroup
[-InputObject] <LocalGroup>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Set-LocalGroup
[-Name] <String>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalGroup
[-SID] <SecurityIdentifier>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-LocalGroup modifie un groupe de sécurité local.
Exemples
Exemple 1 : Modifier une description de groupe
Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."
Cette commande modifie la description d’un groupe local.
Remarque
Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.
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 |
-Description
Spécifie un commentaire pour le groupe. La longueur maximale est de 48 caractères.
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
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie le groupe de sécurité que cette applet de commande change. Pour obtenir un groupe de sécurité, 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 le nom du groupe de sécurité que cette applet de commande change.
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 l’ID de sécurité (SID) du groupe de sécurité que cette applet de commande change.
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: | 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 Set-LocalGroup:
slg
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.
