Share via

Set-LocalUser

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

Modifie un compte d’utilisateur local.

Syntax

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é Administration 07.

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountNeverExpires

Indique que le compte n’expire pas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-Description

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

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

-Name

Spécifie le nom du compte d’utilisateur que cette applet de commande change.

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

-PasswordNeverExpires

Indique si le mot de passe expire.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SID

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

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UserMayChangePassword

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

Type:Boolean
Position:Named
Default value:None
Required:False
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.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.