PowerCLI Reference

New-VICredentialStoreItem

Synopsis

This cmdlet creates a new entry in the credential store.

Syntax

New-VICredentialStoreItem [-Host] <String> [-User] <String> [[-Password] <String>] [[-File] <String>] [<CommonParameters>]

Related Commands

Online version
Get-VICredentialStoreItem
Remove-VICredentialStoreItem

Detailed Description

This cmdlet creates a new entry in the credential store. If there is an existing entry for the specified host and user, it is overwritten. If the credential store file does not exist, it is created (along with its directory if needed). If no file is specified, the item is created in the default credential store file %APPDATA%\VMware\credstore\vicredentials.xml. Credential store items for vCloud Director servers must contain user name and organization in the following format: user_name:organization_name, where both names are lower-cased.

Parameters

Name	Type	Description	Required?	Pipeline Input
Host	String	Specifies the host for which you want to create the new credentials item.	true	false
User	String	Specifies a user name.	true	false
Password	String	Specifies a password.	false	false
File	String	Specifies a file path where you want to store the new credentials.	false	false

Return Type

The newly created VICredentialStoreItem object

Notes

Examples

-------------- Example 1 --------------

New-VICredentialStoreItem -Host 192.168.1.10 -User Admin -Password pass

Adds a new item in the default credential store file.