Share via


Cmdkey

Applies To: Windows Server 2008, Windows Vista

Creates, lists, and deletes stored user names and passwords or credentials.

For examples of how this command can be used, see Examples.

Syntax

cmdkey [{/add:<TargetName>|/generic:<TargetName>}] {/smartcard|/user:<UserName> [/pass:<Password>]} [/delete{:<TargetName>|/ras}] /list:<TargetName>

Parameters

Parameters Description

/add:<TargetName>

Adds a user name and password to the list.

Requires the parameter of <TargetName> which identifies the computer or domain name that this entry will be associated with.

/generic:<TargetName>

Adds generic credentials to the list.

Requires the parameter of <TargetName> which identifies the computer or domain name that this entry will be associated with.

/smartcard

Retrieves the credential from a smart card.

/user:<UserName>

Specifies the user or account name to store with this entry. If UserName is not supplied, it will be requested.

/pass:<Password>

Specifies the password to store with this entry. If Password is not supplied, it will be requested.

/delete{:<TargetName> | /ras}

Deletes a user name and password from the list. If TargetName is specified, that entry will be deleted. If /ras is specified, the stored remote access entry will be deleted.

/list:<TargetName>

Displays the list of stored user names and credentials. If TargetName is not specified, all stored user names and credentials will be listed.

/?

Displays help at the command prompt.

Remarks

  • If more than one smart card is found on the system when the /smartcard command-line option is used, cmdkey will display information about all available smart cards and then prompt the user to specify which one to use.

  • Passwords will not be displayed once they are stored.

Examples

To display a list of all user names and credentials that are stored, type:

cmdkey /list

To add a user name and password for user Mikedan to access computer Server01 with the password Kleo, type:

cmdkey /add:server01 /user:mikedan /pass:Kleo

To add a user name and password for user Mikedan to access computer Server01 and prompt for the password whenever Server01 is accessed, type:

cmdkey /add:server01 /user:mikedan

To delete the credential that remote access has stored, type:

cmdkey /delete /ras

To delete the credential that is stored for Server01, type:

cmdkey /delete:Server01

Additional references

Command-Line Syntax Key