Add-VBRESX (obsolete)

Short Description

Adds ESXi hosts to Veeam Backup & Replication.

Note

This cmdlet is obsolete and will not be supported in the next version.

Platform: VMware

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

Syntax

This cmdlet provides the following parameter sets:

  • AddCreds

    Add-VBRESX [-Name] <String> [-User] <String> [-Password] <String> [-Port <Int32>] [-SSHUser <String>]

    [-SSHPassword <String>] [-SSHPort <Int32>] [-SSHEnable] [-Description <String>]

    [-SSHCredentials <CCredentials>] [-Force] [<CommonParameters>]

  • SpecificCreds

    Add-VBRESX [-Name] <String> [-Port <Int32>] [-SSHUser <String>] [-SSHPassword <String>] [-SSHPort <Int32>]

    [-SSHEnable] [-Description <String>] -Credentials <CCredentials> [-SSHCredentials <CCredentials>] [-Force] [<CommonParameters>]

Detailed Description

This cmdlet adds ESXi servers to the Veeam Backup & Replication managing console.

If an ESXi host is a part of a vCenter Server, it is recommended to add the vCenter Server instead of a single ESXi host.

When adding a new ESXi server, you will need to provide either a user name and password or credentials. Use an appropriate parameter set for each case.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Credentials

Specifies the credentials you want to use for authenticating with the ESXi server.

CCredentials

True

Named

False

Description

Specifies the description of the ESXi server.

String

False

Named

False

Force

Defines that the cmdlet will add VMware ESXi hosts without showing warnings in the PowerShell console.

SwitchParameter

False

Named

False

Name

Specifies the full DNS name or IP address of the ESXi host.

String

True

0

False

Password

Specifies the password you want to use for authenticating with the ESXi host.

String

True

2

False

Port

Specifies the Web service port for connection to the ESXi host.

Default: 443.

Int32

False

Named

False

SSHCredentials

For SSH connection.

Specify credentials you want to use to authenticate with the service console.

CCredentials

False

Named

False

SSHEnable

For SSH connection.

Defines that the ESXi host is connected using service console connection.

SwitchParameter

False

Named

False

SSHPassword

Specifies the password of the account used for service console connection to the host (recommended).

String

False

Named

False

SSHPort

Specifies the service console port (recommended).

Int32

False

Named

False

SSHUser

Specifies the user name of the account used for service console connection to the host (recommended).

String

False

Named

False

User

Specifies the user name you want to use for authenticating with the ESXi host.

String

True

1

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Examples

Add-VBRESX (obsolete)Example 1. Adding ESXi Host with User Name and Password

This command adds the ESXi host with the 172.16.11.188 IP address. The user name is root and the password is qwerty.

Add-VBRESX -Name 172.16.11.188 -User root -Password qwerty

Add-VBRESX (obsolete)Example 2. Adding ESXi Host with User Name and Password

This example shows how to add the ESXi host with the 172.16.11.188 IP address and authenticates with credentials.

$Administrator = Get-VBRCredentials -Name *Administrator*

Add-VBRESX -Name 172.16.11.188 -Credentials $Administrator

Perform the following steps:

  1. Run the Get-VBRCredentialsReturns credentials records. cmdlet. Specify the Name parameter value. Save the result to the $Administrator variable.
  2. Run the Add-VBRESX cmdlet. Specify the Name parameter value. Set the $Administrator variable as the Credentials parameter value.

Page updated 2026-08-19

Page content applies to build 13.1.1.18