## 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 | Default Value
--- | --- | --- | --- | --- | ---
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.

Copyright © VMware, Inc. All rights reserved.