---
title: "Add-VBRvCloud"
description: "This cmdlet adds a new Cloud Director server to Veeam Backup & Replication infrastructure. Run the Add-VBRvCloudVC cmdlet to add a vCenter Server managed by Cloud Director to Veeam Backup & Replication infrastructure."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrvcloud.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > Add-VBRvCloud"
dateModified: "2026-08-19"
---

# Add-VBRvCloud

## Short Description
Adds a Cloud Director server 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-VBRvCloud [-Name] <String> [-User] <String> [-Password] <String> [-Url <String>] [-Description <String>]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Credentials</code></p>

```
Add-VBRvCloud [-Name] <String> [-Url <String>] [-Description <String>] -Credentials <CCredentials>
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet adds a new Cloud Director server to Veeam Backup & Replication infrastructure.

::: note

Run the [`Add-VBRvCloudVC`](add-vbrvcloudvc.md) cmdlet to add a vCenter Server managed by Cloud Director 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 Cloud Director 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 new Cloud Director server. If not set, the user name who created the server and the date and time of creation will be added by default.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies the full DNS name or IP address of the Cloud Director server or any cell in the Cloud Director infrastructure.</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>0</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 Cloud Director server.</p><p>If you use the Username/Password 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">Url</span></p>
        </td>
        <td>
          <p>Specifies the URL you want to connect to the Cloud Director Web API with.</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">User</span></p>
        </td>
        <td>
          <p>Specifies the user name you want to use for authenticating with the Cloud Director server.</p><p>If you use the Username/Password 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>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">Confirm</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will display a prompt that asks if you want to continue running the command.</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">WhatIf</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.</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>
    </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. Creating Cloud Director Server with User Name and Password

This command creates a new `vCloudDirectorServer` server with the following settings:

- The URL address is `https://vclouddirectorserver:443`.
- The user name is `Administrator` and the password is `password`.
- The description is `Cloud Director Server`.

```
Add-VBRvCloud -Name "vCloudDirectorServer.domain.com" -User Administrator -Password password -Url "https://vclouddirectorserver:443" -Description "Cloud Director Server"
```

:::

::: example
### Example 2. Creating Cloud Director Server with Saved Credentials

This example shows how to create a new `vCloudDirectorServer` server with the following settings:

- The URL address is `https://vclouddirectorserver:443`.
- The user name is `Administrator` and the password is `password`.
- The description is the default one.

```
$administrator = Get-VBRCredentials -Name "Administrator"
Add-VBRvCloud -Name "vCloudDirectorServer.domain.com" -Credentials $administrator -Url "https://vclouddirectorserver:443"
```

Perform the following steps:

1. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$administrator` variable.
2. Run the `Add-VBRvCloud` cmdlet. Specify the `Name` parameter value. Set the `$administrator` variable as the `Credentials` parameter value. Specify the `Url` parameter value.

:::

## Related Commands

[`Get-VBRCredentials`](get-vbrcredentials.md)