Add-VBRCredentials
Short Description
Creates a credentials record.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Add-VBRCredentials -User <String> -Password <String> [-Description <String>] [-Type <VBRCredentialsType>] [-SshPort <Int32>] [-ElevateToRoot] [-AddToSudoers] [-RootPassword <String>] [-PrivateKeyPath <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>] -OR- Add-VBRCredentials [-Description <String>] -Credential <PSCredential> [-Type <VBRCredentialsType>] [-SshPort <Int32>] [-ElevateToRoot] [-AddToSudoers] [-RootPassword <String>] [-PrivateKeyPath <String>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>] |
Related Commands
Detailed Description
This cmdlet creates a new credentials record for authenticating with the instances of your virtual infrastructure. You can add Windows or Linux credentials records including authentication using the Identity/Pubkey method.
You can add a new credentials record by indicating strings for user name and password (unprotected mode), or by supplying a PSCredential object.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
User | Specifies the user name you want to use for authenticating with the instances of your virtual infrastructure. Note that you should use DOMAIN\USERNAME usernames format for all hosts except ESX/ESXi hosts. | True | Named | False | False |
Password | Specifies the password you want to use for authenticating with the instances of your virtual infrastructure. | True | Named | False | False |
Description | Specifies the description for the credentials record. This parameter in non-mandatory, although it is recommended to input this value to make the credential records easily identified. | False | Named | False | False |
Credential | Specifies the credentials you want to add. | False | Named | False | False |
Type | Specifies the credentials type: Linux, Windows, LinuxPubKey. Default: Windows. | False | Named | False | False |
SshPort | Used for Identity/Pubkey authentication method. Specifies the number of the SSH port that you want to use to connect to a Linux server. Permitted values: 1 to 65535. Default: 22. | False | Named | False | False |
ElevateToRoot | Used for Identity/Pubkey authentication method. Indicates that non-root users are provided with root account privileges. | False | Named | False | False |
AddToSudoers | Used for Identity/Pubkey authentication method. Indicates that the user account is added to sudoers file. Default: (if the ElevateToRoot parameter is set to False) False. | False | Named | False | False |
RootPassword | Used for Identity/Pubkey authentication method. Indicates that the root password is used for authentication. | False | Named | False | False |
PrivateKeyPath | Used for Identity/Pubkey authentication method. Specifies the path to the private key. Use this parameter to specify the private key for the LinuxPubKey option of the Type parameter. | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.
Example 1
This command creates a new Windows credentials record for the administrator.
PS C:\PS> Add-VBRCredentials -Type Windows -User Administrator -Password "Password_1" -Description "Administrator Credentials" |
Example 2
This command adds a credentials record for the administrator. Get-Credential is used to enter the username and password in the secure mode.
Example 3
This command adds a Linux credentials record for the administrator. The credentials record will use the 23 SSH port. The root password privileges are given to the user.
PS C:\PS> Add-VBRCredentials -Type Linux -User Administrator -Password password -SshPort 23 -ElevateToRoot -AddToSudoers -RootPassword rootpwd |
Example 4
This command adds a Linux Pubkey credentials record for the 'User1'.