---
title: "Add-VBRvCloudVC"
description: "This cmdlet adds a new vCenter Server to Veeam Backup & Replication infrastructure. The vCenter Server is registered as a part of Cloud Director."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrvcloudvc.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > Add-VBRvCloudVC"
dateModified: "2026-08-19"
---

# 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:

<ul class="syntax-sets">
  <li>
    <p><code>AddCredentials</code></p>

```
Add-VBRvCloudVC [-vCloudServer] <CHost> [-VCInfo] <CVcdVcInfo> [-User] <String> [-Password] <String>
 [-Name <String>] [-Port <Int32>] [-Description <String>] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Credentials</code></p>

```
Add-VBRvCloudVC [-vCloudServer] <CHost> [-VCInfo] <CVcdVcInfo> [-Name <String>] [-Port <Int32>]
 [-Description <String>] -Credentials <CCredentials> [-Force] [<CommonParameters>]
```
  </li>
</ul>

## 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`](add-vbrvcloud.md) cmdlet to add a Cloud Director server to Veeam Backup & Replication infrastructure.

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Credentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials you want to use for authenticating with the vCenter Server.</p><p>If you use the Credentials scenario, the <code>User</code> and <code>Password</code> parameters must be omitted.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Description</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will add a vCenter Server without showing warnings in the PowerShell console.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies the DNS name or IP address of the vCenter Server you want to connect.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Password</span></p>
        </td>
        <td>
          <p>Specifies the password you want to use for authenticating with the vCenter Server.</p><p>If you use the <code>User</code>/<code>Password</code> scenario, the <code>Credentials</code> parameter must be omitted.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>3</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Port</span></p>
        </td>
        <td>
          <p>Specifies the web-service port number. If not set, the default port number 443 will be used.</p><p><strong>Note</strong>: When you customize the port number, you must set this port on the vCenter Server/ESXi host settings first.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">User</span></p>
        </td>
        <td>
          <p>Specifies the user name you want to use for authenticating with the vCenter Server.</p><p>If you use the <code>User</code>/<code>Password</code> scenario, the <code>Credentials</code> parameter must be omitted.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>2</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">VCInfo</span></p>
        </td>
        <td>
          <p>Specifies the vCenter Server you want to connect to the Cloud Director.</p><p>Accepts the <code>CVcdVcInfo</code> object. To get this object, run the <a href="find-vbrvcloudentity.md"><code>Find-VBRvCloudEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CVcdVcInfo</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>1</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">vCloudServer</span></p>
        </td>
        <td>
          <p>Specifies the Cloud Director server you want to connect a vCenter to.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
`CHost`

## Examples

::: example
### 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:

1. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Provide the `Vc` parameter. Save the result to the `$vc` variable.
2. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value.
3. 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.

:::

::: example
### 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:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$s` variable.
2. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Provide the `Vc` parameter. Save the result to the `$vc` variable.
3. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Specify the `Name` parameter value. Save the credentials to the `$creds` variable.
4. 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.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md)
- [`Get-VBRCredentials`](get-vbrcredentials.md)