Set-VBRLinuxFileRestoreHelperHost

Short Description

Modifies temporary Linux helper host specifications.

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

AddCredentials (Default)

Set-VBRLinuxFileRestoreHelperHost -HelperHost <VBRLinuxFileRestoreHelperHost> -SSHUser <String>

-SSHPassword <String> [-SSHPort <Int32>] [-SSHElevateToRoot] [-SSHAddToSudoers] [-SSHFailoverToSu]

[-SSHRootPassword <String>] [-SSHFingerprint <String>] [-Force] [<CommonParameters>]

Credentials

Set-VBRLinuxFileRestoreHelperHost -HelperHost <VBRLinuxFileRestoreHelperHost> [-Credentials <CCredentials>]

[-SSHFingerprint <String>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet modifies temporary Linux helper host specifications.

Note that the cmdlet creates a copy of the HelperHost you provide in a command. To use the new helper host, you must assign it to a variable.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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-VBRCredentials` cmdlet.	`CCredentials`	False	Named	False
Force	Defines that the cmdlet will modify temporary Linux helper host specification without showing warnings in the PowerShell console.	`SwitchParameter`	False	Named	False
HelperHost	Specifies the temporary Linux helper host. Accepts the `VBRLinuxFileRestoreHelperHost` object. To get this object, run the `New-VBRLinuxFileRestoreHelperHost` cmdlet.	`VBRLinuxFileRestoreHelperHost`	True	Named	True (ByPropertyName, ByValue)
SSHAddToSudoers	Defines that the user account is added to sudoers file. Default: `False`.	`SwitchParameter`	False	Named	False
SSHElevateToRoot	Defines that non-root users are provided with the root account privileges. Default: `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
SSHFingerprint	Specifies the SSH host fingerprint.	`String`	False	Named	False
SSHPassword	Specifies the password you want to use for authenticating with the Linux server.	`String`	True	Named	False
SSHPort	Specifies the SSH port for connection to the Linux server. Default: 22.	`Int32`	False	Named	False
SSHRootPassword	Specifies the root password used for authentication.	`String`	False	Named	False
SSHUser	Specifies the user name you want to use for authenticating with the Linux server.	`String`	True	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 VBRLinuxFileRestoreHelperHost object that contains settings for a temporary Linux helper host specifications.

Examples

Set-VBRLinuxFileRestoreHelperHost Example 1. Modifying Connectivity Options Using Existing Credentials

This example shows how to modify the connectivity options using the credentials that already exist in Veeam Backup & Replication.

$cred1 = Get-VBRCredentials -Name "root"

$cred2 = Get-VBRCredentials -Name "Linux Admin"

$hh1 = New-VBRLinuxFileRestoreHelperHost -Force -Name "154.19.90.152" -Credentials $cred1

$hh2 = Set-VBRLinuxFileRestoreHelperHost -HelperHost $hh1 -Credentials $cred2

Perform the following steps:

Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the result to the $cred1 variable.
Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the result to the $cred2 variable.
Run the New-VBRLinuxFileRestoreHelperHost cmdlet. Provide the Force parameter. Specify the Name parameter value. Set the $cred1 variable as the Credentials parameter value. Save the result to the $hh1 variable.
Run the Set-VBRLinuxFileRestoreHelperHost cmdlet. Set the $hh1 variable as the HelperHost parameter value. Set the $cred2 variable as the Credentials parameter value. Save the result to the $hh2 variable.

Set-VBRLinuxFileRestoreHelperHost Example 2. Modifying Connectivity Options by Specifying SSH Options

This example shows how to modify the connectivity options by specifying each SSH option separately.

$cred1 = Get-VBRCredentials -Name "root"

$hh1 = New-VBRLinuxFileRestoreHelperHost -Force -Name "Linux User" -Credentials $cred1

$hh2 = Set-VBRLinuxFileRestoreHelperHost -HelperHost $hh1 -SSHUser LinuxUser -SSHPassword P@ssw0rd -SSHElevateToRoot

Perform the following steps:

Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the result to the $cred1 variable.
Run the New-VBRLinuxFileRestoreHelperHost cmdlet. Provide the Force parameter. Specify the Name parameter value. Set the $cred1 variable as the Credentials parameter value. Save the result to the $hh1 variable.
Run the Set-VBRLinuxFileRestoreHelperHost cmdlet. Specify the following settings:

Set the $hh1 variable as the HelperHost parameter value.
Specify the SSHUser parameter value.
Specify the SSHPassword parameter value.
Provide the SSHElevateToRoot parameter.

Save the result to the $hh2 variable.