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

<CommonParameters>

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