Add-VBRvCloudVC

Short Description

Adds vCenter Server managed by Cloud Director to Veeam Backup & Replication.

Platform: VMware

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

Syntax

This cmdlet provides the following parameter sets:

AddCredentials

Add-VBRvCloudVC [-vCloudServer] <CHost> [-VCInfo] <CVcdVcInfo> [-User] <String> [-Password] <String>

[-Name <String>] [-Port <Int32>] [-Description <String>] [-Force] [<CommonParameters>]
Credentials

Add-VBRvCloudVC [-vCloudServer] <CHost> [-VCInfo] <CVcdVcInfo> [-Name <String>] [-Port <Int32>]

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

Detailed Description

This cmdlet adds a new vCenter Server to Veeam Backup & Replication infrastructure. The vCenter Server is registered as a part of Cloud Director.

Note

Run the Add-VBRvCloud cmdlet to add a Cloud Director server to Veeam Backup & Replication infrastructure.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Credentials	Specifies the credentials you want to use for authenticating with the vCenter Server. If you use the Credentials scenario, the `User` and `Password` parameters must be omitted.	`CCredentials`	True	Named	False
Description	Specifies the description of the vCenter Server. If not set, the default description containing the user name of the user who created the record and date and time of creation will be used.	`String`	False	Named	False
Force	Defines that the cmdlet will add a vCenter Server without showing warnings in the PowerShell console.	`SwitchParameter`	False	Named	False
Name	Specifies the DNS name or IP address of the vCenter Server you want to connect.	`String`	False	Named	False
Password	Specifies the password you want to use for authenticating with the vCenter Server. If you use the `User`/`Password` scenario, the `Credentials` parameter must be omitted.	`String`	True	3	False
Port	Specifies the web-service port number. If not set, the default port number 443 will be used. Note: When you customize the port number, you must set this port on the vCenter Server/ESXi host settings first.	`Int32`	False	Named	False
User	Specifies the user name you want to use for authenticating with the vCenter Server. If you use the `User`/`Password` scenario, the `Credentials` parameter must be omitted.	`String`	True	2	False
VCInfo	Specifies the vCenter Server you want to connect to the Cloud Director. Accepts the `CVcdVcInfo` object. To get this object, run the `Find-VBRvCloudEntity` cmdlet.	`CVcdVcInfo`	True	1	False
vCloudServer	Specifies the Cloud Director server you want to connect a vCenter to.	`CHost`	True	0	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

CHost

Examples

Add-VBRvCloudVC Example 1. Adding vCenter Server with User Name and Password [Using Pipeline]

This example shows how to add a new vCenter Server with the following parameters:

The vCenter will be registered on the server with 172.16.1.13 IP address.
The user name is Administrator and the password is Password.
The Port parameter is not set to enable the default 443 web-service port number.
The Description parameter is not set to enable the default description.

$vc = Find-VBRvCloudEntity -Vc

Get-VBRServer -Name "172.16.1.13" | Add-VBRvCloudVC -VCInfo $vc -User "Administrator" -Password "Password" -Name "vCenter Server 1"

Perform the following steps:

Run the Find-VBRvCloudEntity cmdlet. Provide the Vc parameter. Save the result to the $vc variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value.
Pipe the cmdlet output to the Add-VBRvCloudVC cmdlet. Specify the following settings:
- Set the $vc variable as the VCInfo parameter value.
- Specify the User and the Password parameter values.
- Specify the Name parameter value.

Add-VBRvCloudVC Example 2. Adding vCenter Server with Saved Credentials [Using Variable]

This command adds a new vCenter Server with the following parameters:

The vCenter will be registered on the server with 172.16.1.13 IP address.
The Port parameter is set to 456.
The Description parameter is not set to enable the default description.

$s = Get-VBRServer -Name "172.16.1.13"

$vc = Find-VBRvCloudEntity -Vc

$creds = Get-VBRCredentials -Name "vCenter Administrator"

Add-VBRvCloudVC -vCloudServer $s -VCInfo $vc -Credentials $creds -Name "vCenter Server 2" -Port 456

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $s variable.
Run the Find-VBRvCloudEntity cmdlet. Provide the Vc parameter. Save the result to the $vc variable.
Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the credentials to the $creds variable.
Run the Add-VBRvCloudVC cmdlet. Specify the following settings:
- Set the $s variable as the vCloudServer parameter value.
- Set the $vc variable as the VCInfo parameter value.
- Set the $creds variable as the Credentials parameter value.
- Specify the Name parameter value.
- Specify the Port parameter value.