---
title: "Add-VBRvCloudJob"
description: "Creates a Cloud Director backup job. Platform: VMware Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates a new Cloud Director backup job."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrvcloudjob.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > Add-VBRvCloudJob"
dateModified: "2026-08-19"
---

# Add-VBRvCloudJob

## Short Description
Creates a Cloud Director backup job.

**Platform**: VMware

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

## Syntax
```
Add-VBRvCloudJob [-Name <String>] [-BackupRepository <CBackupRepository>] -Entity <IVcdItem[]>
 [-Description <String>] [-HighPriority] [-EncryptionKey <PSCryptoKey>] [-KMSServer <VBRKMSServer>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a new Cloud Director backup job.

You should always use Cloud Director backup jobs to back up VMs managed by Cloud Director. If you back up VMs managed by Cloud Director using a regular backup job, Veeam Backup & Replication will perform backup at the level of the underlying vCenter Server and will not capture vApp metadata. As a result, it will not let you restore a fully functioning VM to Cloud Director.

Note that when you create a backup job, you need to run it manually unless you enable a job schedule.

Run the [`Start-VBRJob`](start-vbrjob.md) cmdlet to start the created job.

Run the [`Set-VBRJobSchedule`](set-vbrjobschedule.md) cmdlet to set schedule for the job.

## 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">BackupRepository</span></p>
        </td>
        <td>
          <p>Specifies the target backup repository.</p><p>Default: default backup repository.</p><p>Accepts the <code>CBackupRepository</code> object. To get this object, run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CBackupRepository</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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the new Cloud Director backup job.</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">EncryptionKey</span></p>
        </td>
        <td>
          <p>Specifies the encryption key that you want to use to encrypt the data.</p><p>Accepts the <code>PSCryptoKey</code> object. To create this object, run the <a href="get-vbrencryptionkey.md"><code>Get-VBREncryptionKey</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="pscryptokey.md"><code>PSCryptoKey</code></a></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">Entity</span></p>
        </td>
        <td>
          <p>Specifies the array of VMs. The cmdlet will add these VMs to the Cloud Director backup job.</p><p>Accepts the <code>IVcdItem[]</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>IVcdItem[]</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HighPriority</span></p>
        </td>
        <td>
          <p>Defines that Veeam Backup & Replication will prioritize this job higher than other similar jobs and will allocate resources to it in the first place.</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">KMSServer</span></p>
        </td>
        <td>
          <p>Specifies KMS servers added to the Veeam Backup & Replication console. The cmdlet will decrypt data encrypted by this server.</p><p>Accepts the <a href="vbrkmsserver.md"><code>VBRKMSServer</code></a> object. To get this object, run the <a href="get-vbrkmsserver.md"><code>Get-VBRKMSServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrkmsserver.md"><code>VBRKMSServer</code></a></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 name you want to assign to the Cloud Director backup job.</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>
    </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
`CBackupJob`

## Examples

::: example
### Example 1. Adding Cloud Director Backup Job [Using Variable]

This example shows how to create a new Cloud Director backup job.

```
$vm = Find-VBRvCloudEntity -Name "vCloud Server"
$brepository = Get-VBRBackupRepository -Name "Backups Vol2"
Add-VBRvCloudJob -Entity $vm -Name "vCD Backup Job" -BackupRepository $brepository -Description "Cloud Director Backup Job"
```

Perform the following steps:

1. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vm` variable.
2. Run the [`Get-VBRBackupRepository`](get-vbrbackuprepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$brepository` variable.
3. Run the `Add-VBRvCloudJob` cmdlet. Specify the following settings:

   - Set the `$vm` variable as the `Entity` parameter value.
   - Specify the `Name` parameter value.
   - Set the `$brepository` variable as the `BackupRepository` parameter value.
   - Specify the `Description` parameter value.

:::

::: example
### Example 2. Adding Cloud Director Backup Job [Using Pipeline]

This example shows how to create a new Cloud Director backup job. The target is the default backup repository.

```
Find-VBRvCloudEntity -Name "vCloud Server" | Add-VBRvCloudJob -Name "vCD Backup Job 2" -Description "Cloud Director Backup Job"
```

Perform the following steps:

1. Run the [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md) cmdlet. Specify the `Name` parameter value.
2. Pipe the cmdlet output to the `Add-VBRvCloudJob` cmdlet. Specify the `Name` and the `Description` parameter values.

:::

## Related Commands

- [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md)
- [`Get-VBRBackupRepository`](get-vbrbackuprepository.md)