Rename-LocalUser

PackageDeployment Module Help	Package Deployment Module
Rename-LocalUser Cmdlet	Version 4.0.0.5

Rename-LocalUser

Synopsis

Rename Local User Account

Syntax

Rename-LocalUser [-Name] <String> [-NewName] <String> [[-Context] <String>] [-ContinueOnError] [<CommonParameters>]

Description

Use this command to rename a local user account.

Parameters

-Context <String>

User: Execution under user account; logging in HKEY_CURRENT_USER, i.e. for the user.
UserPerService: User-related command, execution in Service context.
Computer: Execution under user account; logging in HKEY_CURRENT_MACHINE, i.e. for the computer.
ComputerPerService: Execution in service context; logging in HKEY_LOCAL_MACHINE, i.e. for the computer.

Required	False
Position	2
Accepts pipeline input	False

-ContinueOnError <SwitchParameter>

Continues script execution in spite of errors in the respective command

Required	False
Position	Named
Accepts pipeline input	False

-Name <String>

Enter the user account name.

Required	True
Position	0
Accepts pipeline input	False

-NewName <String>

Enter the user account’s new name. Enter a unique user account name (you cannot use a name that already exists on the workstation). The name can have up to 20 characters (upper and lower case) with the exception of the following characters: " / \ [ ] : ; | = , + * ? < >. Please note that you should not assign a name consisting only of periods (.) and blanks.

Required	True
Position	1
Accepts pipeline input	False

For more information about common parameters, type "Get-Help about_CommonParameters".