Set-LocalUser
Modifie un compte d’utilisateur local.
Syntaxe
Name (Par défaut)
Set-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-LocalUser
[-InputObject] <LocalUser>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalUser
[-SID] <SecurityIdentifier>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-LocalUser modifie un compte d’utilisateur local. Cette applet de commande peut réinitialiser le mot de passe d’un compte d’utilisateur local.
Remarque
Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.
Exemples
Exemple 1 : Modifier une description d’un compte d’utilisateur
Set-LocalUser -Name "Admin07" -Description "Description of this account."
Cette commande modifie la description d’un compte d’utilisateur nommé Admin07.
Exemple 2 : Modifier le mot de passe sur un compte
$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password
La première commande vous invite à entrer un mot de passe à l’aide de l’applet de commande Read-Host. La commande stocke le mot de passe sous forme de chaîne sécurisée dans la variable $Password.
La deuxième commande obtient un compte d’utilisateur nommé User02 à l’aide de Get-LocalUser. La commande stocke le compte dans la variable $UserAccount.
La troisième commande définit le nouveau mot de passe sur le compte d’utilisateur stocké dans $UserAccount.
Paramètres
-AccountExpires
Spécifie quand le compte d’utilisateur expire. Pour obtenir un objet DateTime, utilisez l’applet de commande Get-Date.
Si vous ne souhaitez pas que le compte expire, spécifiez le paramètre AccountNeverExpires.
Propriétés du paramètre
| Type: | DateTime |
| 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AccountNeverExpires
Indique que le compte n’expire pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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 compte d’utilisateur. 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FullName
Spécifie le nom complet du compte d’utilisateur. Le nom complet diffère du nom d’utilisateur du compte d’utilisateur.
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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie le compte d’utilisateur que cette applet de commande change. Pour obtenir un compte d’utilisateur, utilisez l’applet de commande Get-LocalUser.
Propriétés du paramètre
| Type: | Microsoft.PowerShell.Commands.LocalUser |
| 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 compte d’utilisateur 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
Name
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Password
Spécifie un mot de passe pour le compte d’utilisateur. Si le compte d’utilisateur est connecté à un compte Microsoft, ne définissez pas de mot de passe.
Vous pouvez utiliser Read-Host -AsSecureString, Get-Credentialou ConvertTo-SecureString pour créer un objet SecureString pour le mot de passe.
Si vous omettez les paramètres mot de passe et paramètres de NoPassword, Set-LocalUser vous invite à entrer le mot de passe de l’utilisateur.
Propriétés du paramètre
| Type: | SecureString |
| 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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PasswordNeverExpires
Indique si le mot de passe expire.
Propriétés du paramètre
| Type: | Boolean |
| 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: | False |
| 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é (SID) du compte d’utilisateur modifié par cette applet de commande.
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 |
-UserMayChangePassword
Indique que l’utilisateur peut modifier le mot de passe sur le compte d’utilisateur.
Propriétés du paramètre
| Type: | Boolean |
| 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: | False |
| 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.LocalUser
Vous pouvez diriger un utilisateur 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 Set-LocalUser:
slu
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.
