New-VBRLinuxFileRestoreHelperHost

Short Description

Creates temporary Linux helper host used to launch the Guest OS File Restore.

Applies to

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Create a Linux helper host with credentials that already exist in Veeam Backup & Replication.

New-VBRLinuxFileRestoreHelperHost [-Credentials <CCredentials>] [-Force] [-Name <string>] [-SSHFingerprint <string>]  [<CommonParameters>]

  • Create a Linux helper host with a new set of credentials.

New-VBRLinuxFileRestoreHelperHost [-Force] [-Name <string>] [-SSHAddToSudoers] [-SSHElevateToRoot] [-SSHFailoverToSu] [-SSHFingerPrint <string>] [-SSHPassword <String>] [-SSHPort <int>] [-SSHRootPassword <string>] [-SSHUser <string>]  [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRLinuxFileRestoreHelperHost object. This object contains connectivity parameters and a fingerprint.

Note

If you create a Linux helper host with the second parameter set, a new set of credentials will be created each time you run the New-VBRLinuxFileRestoreHelperHost cmdlet.

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.

True

Named

False

Force

Defines that the cmdlet will add temporary Linux helper host specification without showing warnings in the PowerShell console.

SwitchParameter

False

Named

False

Name

Specifies the DNS name or IP address of the Linux server.

String

True

Named

False

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.

Examples

New-VBRLinuxFileRestoreHelperHostExample 1. Creating Temporary Linux Helper Host with Existing Credentials

New-VBRLinuxFileRestoreHelperHostExample 2. Creating Temporary Linux Helper Host with New Credentials

Related Commands

Page updated 11/29/2024

Page content applies to build 12.3.1.1139