Rename-LocalUser

Référence

Module:: Microsoft.PowerShell.LocalAccounts

Renomme un compte d’utilisateur local.

Syntaxe

Rename-LocalUser
      [-InputObject] <LocalUser>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-LocalUser
      [-Name] <String>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-LocalUser
      [-NewName] <String>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Rename-LocalUser renomme un compte d’utilisateur local.

Note

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Renommer un compte d’utilisateur

Rename-LocalUser -Name "Admin02" -NewName "AdminContoso02"

Cette commande renomme le compte d’utilisateur nommé Admin02.

Paramètres

-Confirm

Vous invite à confirmer 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

-InputObject

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

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 renomme.

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

-NewName

Spécifie un nouveau nom pour le compte d’utilisateur.

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

-SID

Spécifie l’ID de sécurité (SID) d’un compte d’utilisateur renommé 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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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 aucune sortie.

Notes

Windows PowerShell inclut les alias suivants pour Rename-LocalUser:

rnlu

La propriété PrincipalSource est une propriété sur LocalUser, LocalGroupet objets 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.