Add-VBRLinux
Short Description
Adds a Linux server to the backup infrastructure.
Applies to
Platform: VMware
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
This cmdlet provides parameter sets that allow you to:
- Add a Linux host using credentials for authentication.
Add-VBRLinux -Name <string> -Credentials <CCredentials> [-Description <string>] [-SSHPort <int>] [-SSHFingerprint <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
- Add a Linux host using the Username/Password for authentication.
Add-VBRLinux -Name <string> -SSHUser <string> -SSHPassword <string> [-Description <string>] [-SSHPort <int>] [-SSHElevateToRoot] [-SSHAddToSudoers] [-SSHFailoverToSu] [-SSHRootPassword <string>] [-SSHTempCredentials] [-SSHFingerprint <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
- Add a Linux host as a temporary helper appliance.
Add-VBRLinux -Credentials <CCredentials> -HelperHostName <string> [-Description <string>] [-SSHFingerprint <String>] [-WhatIf] [-Confirm] [<CommonParameters>] |
Detailed Description
This cmdlet adds a Linux server to the backup infrastructure.
Note |
Consider the following:
|
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
---|---|---|---|---|---|
Name | Specifies the DNS name or IP address of the Linux server. | String | True | 1 | False |
SSHUser | Specifies the user name you want to use for authenticating with the Linux server. Note: To add a Linux host using an SSH key fingerprint, provide the Confirm parameter. | String | True | 2 | False |
SSHPassword | Specifies the password you want to use for authenticating with the Linux server. Note: To add a Linux host using an SSH key fingerprint, provide the Confirm parameter. | String | True | 3 | False |
Credentials | Specifies the credentials you want to use for authenticating with the Linux server. | Accepts the CCredentials object. To get this object, run the Get-Credential cmdlet. | True | Named | False |
HelperHostName | Specifies the DNS name or IP address of the temporary helper appliance. | String | True | Named | False |
SSHPort | Specifies the SSH port for connection to the Linux server. Default: 22 | Int | False | Named | False |
SSHElevateToRoot | Defines that non-root users are provided with the root account privileges. Default: False. | SwitchParameter | False | Named | False |
SSHAddToSudoers | Defines that the user account is added to sudoers file. Default: (if the ElevateToRoot parameter is set to False) False. | SwitchParameter | False | Named | False |
SSHFailoverToSu | Defines that Veeam Backup & Replication will use the su command if the sudo command fails. Default: False. | SwitchParameter | False | Named | False |
SSHRootPassword | Specifies the root password used for authentication. | String | False | Named | False |
SSHTempCredentials | To add a Linux server that will be used as a hardened repository. Defines that the cmdlet will use single-use credentials to access a Linux server. Default: False. | SwitchParameter | False | Named | False |
Description | Specifies the description of the Linux server. | String | False | Named | False |
SSHFingerprint | Specifies SSH host fingerprint. | String | False | Named | False |
WhatIf | Defines whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action. | SwitchParameter | False | Named | False |
Confirm | Defines whether the cmdlet displays a prompt that asks if the user is sure that they want to continue. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
The cmdlet returns the CHost object that contains settings of a Linux server added to the backup infrastructure.
Examples
Example 1. Adding Linux Host Using Credentials for Authentication
This example shows how add a Linux host using credentials for authentication.
Perform the following steps:
|
Example 2. Adding Linux Host Using Username/Password for Authentication
This command adds the 198.51.100.2 Linux server.
|
Example 3. Adding Linux Host as Temporary Helper Appliance
This example shows how add the 198.51.100.1 Linux host as a temporary helper appliance.
Perform the following steps:
|
Example 4. Adding Linux Server Using SSH Key Fingerprint
This example shows how to add the 198.51.100.5 Linux server using an SSH key fingerprint. The cmdlet adds the Linux server with the following settings:
|
Related Commands