Partager via

Set-LocalUser

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

Modifie un compte d’utilisateur local.

Syntaxe

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Name] <String>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-InputObject] <LocalUser>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-SID] <SecurityIdentifier>
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet Set-LocalUser de commande 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 Get-LocalUserde . 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 Get-Date de commande.

Si vous ne souhaitez pas que le compte expire, spécifiez le paramètre AccountNeverExpires .

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AccountNeverExpires

Indique que le compte n’expire pas.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-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

-Description

Spécifie un commentaire pour le compte d’utilisateur. La longueur maximale est de 48 caractères.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FullName

Spécifie le nom complet du compte d’utilisateur. Le nom complet diffère du nom d’utilisateur du compte d’utilisateur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie le compte d’utilisateur que cette applet de commande change. Pour obtenir un compte d’utilisateur, utilisez l’applet de Get-LocalUser commande.

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
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 compte d’utilisateur que cette applet de commande change.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 NoPassword , Set-LocalUser vous invite à entrer le mot de passe de l’utilisateur.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PasswordNeverExpires

Indique si le mot de passe expire.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SID

Spécifie l’ID de sécurité (SID) du compte d’utilisateur modifié par cette applet de commande.

Type:SecurityIdentifier
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UserMayChangePassword

Indique que l’utilisateur peut modifier le mot de passe sur le compte d’utilisateur.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
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.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 pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Set-LocalUser:

  • slu

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.