This is an archive version of the document. To get the most up-to-date information, see the current version.Add-VBRCredentials
Short Description
Creates credentials records.
Applies to
Platform: VMware, Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
This cmdlet provides parameter sets that allow you to:
- Add credentials records by a user name and a password.
Add-VBRCredentials -User <string> -Password <string> [-Description <string>] [-Type {Linux | Windows | LinuxPubKey}] [-SshPort <int>] [-Passphrase <string>] [-ElevateToRoot] [-AddToSudoers] [-FailoverToSu][-RootPassword <string>] [-PrivateKeyPath <string>] [-PrivateKey <string>] [<CommonParameters>] |
- Add credentials records by specifying the user credentials.
Add-VBRCredentials -Credential <pscredential> [-Description <string>] [-Type {Linux | Windows | LinuxPubKey}][-SshPort <int>] [-Passphrase <string>] [-ElevateToRoot] [-AddToSudoers] [-FailoverToSu] [-RootPassword <string>][-PrivateKeyPath <string>] [-PrivateKey <string>] [<CommonParameters>] |
Detailed Description
This cmdlet creates a new credentials record that you can use to:
- Authenticate with the instances of your virtual infrastructure.
- Add Windows or Linux credentials records including authentication using the Identity/Pubkey method.
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|---|---|---|---|---|
User | Specifies a user name you want to use for authenticating with instances of your virtual infrastructure. Note: You should use DOMAIN\username format for all hosts except ESX/ESXi hosts. | String | True | Named | False |
Password | Specifies a password you want to use for authenticating with instances of your virtual infrastructure. | String | True | Named | False |
Credential | Specifies credentials you want to add. | Accepts the PSCredential object. To get this object, run the Get-Credential cmdlet. | True | Named | False |
Description | Specifies a description for a credentials record. It is recommended to input this value to make credential records easily identified. | String | False | Named | False |
Type | Specifies the credentials type: Linux, Windows, LinuxPubKey. Default: Windows. | VBRCredentialsType | False | Named | False |
SshPort | For the Identity/Pubkey authentication method. Specifies a number of an SSH port that you want to use to connect to a Linux server. Permitted values: 1 to 65535. Default: 22. | Int32 | False | Named | False |
Passphrase | Specifies a passphrase for a Linux private key on the backup server. | String | False | Named | False |
ElevateToRoot | For the Identity/Pubkey authentication method. Defines that non-root users are provided with root account privileges. | SwitchParameter | False | Named | False |
AddToSudoers | For the Identity/Pubkey authentication method. Defines that a user account is added to sudoers file. Default: (if the ElevateToRoot parameter is set to False) False. | SwitchParameter | False | Named | False |
FailoverToSu | Defines that Veeam Backup & Replication will use the su command if the sudo command fails. If you provide this parameter, Veeam Backup & Replication will failover to the su command if sudo command fails. Otherwise, if sudo fails Veeam Backup & Replication will not be able to add Linux credentials records. | SwitchParameter | False | Named | False |
RootPassword | For the Identity/Pubkey authentication method. Specifies a root password for authentication. | String | False | Named | False |
PrivateKeyPath | For the Identity/Pubkey authentication method. The private key is located at the c:\temp\deneb.ppk path. Use this parameter to specify a private key for the Linux public key option of the Type parameter. | String | False | Named | False |
PrivateKey | For the Identity/Pubkey authentication method. Specifies a private key. | String | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
Output Object
The cmdlet returns the CCredentials object that contains user credentials records.
Examples
Example 1. Creating New Windows Credentials Record Using User Name and Password
Example 2. Creating New Credentials Record for Administrator
Example 3. Creating New Linux Credentials Record for Administrator
Example 4. Adding Linux Pubkey Credentials Record
Related Commands
