---
title: "Add-VBRCloudCDPPolicy"
description: "This cmdlet creates a cloud CDP policy. The cmdlet will create a cloud CDP policy in the disabled state unless you enable a policy schedule. Run the Enable-VBRCDPPolicy cmdlet to enable the policy."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrcloudcdppolicy.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Continuous Data Protection (CDP) with Veeam Cloud Connect > Add-VBRCloudCDPPolicy"
dateModified: "2026-08-20"
---

# Add-VBRCloudCDPPolicy

## Short Description
Creates a cloud CDP policy.

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

## Syntax
```
Add-VBRCloudCDPPolicy -Entity <IViItem[]> -Server <VBRCloudServer> -Datastore <VBRCloudDatastore>
 [-Name <String>] [-Description <String>] [-Suffix <String>] [-SourceProxy <VBRCDPProxy[]>]
 [-NotificationOptions <VBRNotificationOptions>] [-RetentionOptions <VBRCDPPolicyRetentionOptions>]
 [-GuestProcessingOptions <VBRReplicaApplicationProcessingOptions>] [-SourceNetwork <VBRViNetworkInfo[]>]
 [-TargetNetwork <VBRCloudServerNetworkInfo[]>] [-RepositorySeed <CBackupRepository>]
 [-OriginalVM <CViVmItem[]>] [-ReplicaVM <VBRViCloudVM[]>] [-DiskType <EDiskCreationMode>] [-Force]
 [-HighPriority] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a cloud CDP policy.

::: note

The cmdlet will create a cloud CDP policy in the disabled state unless you enable a policy schedule. Run the [`Enable-VBRCDPPolicy`](enable-vbrcdppolicy.md) cmdlet to enable the policy.

:::

## 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">Datastore</span></p>
        </td>
        <td>
          <p>Returns datastores or disk volumes allocated under cloud resources. The cmdlet will keep cloud CDP replicas in this datastore.</p><p>Accepts the <code>VBRCloudDatastore</code> object. To get this object, run the <a href="get-vbrclouddatastore.md"><code>Get-VBRCloudDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrclouddatastore.md"><code>VBRCloudDatastore</code></a></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 a description of a cloud CDP policy.</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">DiskType</span></p>
        </td>
        <td>
          <p>Specifies the format that will be used to restore replica disk files:</p><ul><li><code>Source</code>: the restored replica disks will be the same format as source.</li><li><code>Thick</code>: the restored replica disks will be thick.</li><li><code>Thin</code>: the restored replica disks will be thin.</li><li><code>ThickEagerZeroed</code>: the restored replica disks will be thick eager zeroed.</li></ul><p>Default: <code>Source</code>.</p>
        </td>
        <td style="width:10%;">
          <p><code>EDiskCreationMode</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">Entity</span></p>
        </td>
        <td>
          <p>Specifies the array of VMs you want to add to the policy.</p><p>Accepts the <code>IViItem[]</code> object. To create this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IViItem[]</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will create a cloud CDP policy 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">GuestProcessingOptions</span></p>
        </td>
        <td>
          <p>Specifies guest processing settings of a cloud CDP policy.</p><p>Accepts the <code>VBRReplicaApplicationProcessingOptions</code> object. To create this object, run the <a href="new-vbrreplicaapplicationprocessingoptions.md"><code>New-VBRReplicaApplicationProcessingOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRReplicaApplicationProcessingOptions</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">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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name you want to assign to a cloud CDP policy.</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">NotificationOptions</span></p>
        </td>
        <td>
          <p>Specifies notification settings of a cloud CDP policy.</p><p>Accepts the <code>VBRNotificationOptions</code> object. To create this object, run the <a href="new-vbrnotificationoptions.md"><code>New-VBRNotificationOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnotificationoptions.md"><code>VBRNotificationOptions</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">OriginalVM</span></p>
        </td>
        <td>
          <p>For replica mapping.</p><p>Specifies an array of production VMs that you want to replicate using replica mapping.</p><p>The cloud CDP policy will map this VM to the VM in the disaster recovery site.</p><p>Use the <code>ReplicaVM</code> parameter to specify the replicated VM on the disaster recovery site.</p><p>Accepts the <code>CViVmItem[]</code> object. To get this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViVmItem[]</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">ReplicaVM</span></p>
        </td>
        <td>
          <p>For replica mapping.</p><p>Specifies an array of VMs in the disaster recovery site. The cmdlet will map the production VM to this VM.</p><p>Use the <code>OriginalVM</code> parameter to specify the production VM.</p><p>Accepts the <code>CViVmItem[]</code> object. To get this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViCloudVM[]</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">RepositorySeed</span></p>
        </td>
        <td>
          <p>For replica seeding.</p><p>Specifies a backup repository that keeps a full backup of VMs that you want to replicate.</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">RetentionOptions</span></p>
        </td>
        <td>
          <p>Specifies retention settings of a cloud CDP policy.</p><p>Accepts the <code>VBRCDPPolicyRetentionOptions</code> object. To create this object, run the <a href="new-vbrcdppolicyretentionoptions.md"><code>New-VBRCDPPolicyRetentionOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCDPPolicyRetentionOptions</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">Server</span></p>
        </td>
        <td>
          <p>Specifies a cloud host allocated by a service provider through the hardware plan. The cloud CDP replicas will be created in this host.</p><p>Accepts the <code>VBRCloudServer</code> object. To get this object, run the <a href="get-vbrcloudserver.md"><code>Get-VBRCloudServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudserver.md"><code>VBRCloudServer</code></a></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">SourceNetwork</span></p>
        </td>
        <td>
          <p>For network mapping.</p><p>Specifies an array of production networks to which the VMs added to a cloud CDP policy are connected.</p><p><strong>Note</strong>: The number of source networks must match the number of target networks.</p><p>Accepts the <code>VBRViNetworkInfo[]</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo[]</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">SourceProxy</span></p>
        </td>
        <td>
          <p>Specifies the array of CDP source proxies added to the backup infrastructure. The cmdlet will use these proxies to transfer data.</p><p>Default: Automatic selection.</p><p>Accepts the <code>VBRCDPProxy[]</code> object. To get this object, run the <a href="get-vbrcdpproxy.md"><code>Get-VBRCDPProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCDPProxy[]</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">Suffix</span></p>
        </td>
        <td>
          <p>Specifies the suffix that will be appended to the name of the VM you are replicating. This name will be used to register the replicated VM on the target server.</p><p><strong>Note</strong>: If you omit this parameter, the replicated VMs will get the <code>_replica</code> suffix.</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">TargetNetwork</span></p>
        </td>
        <td>
          <p>For network mapping.</p><p>Specifies an array of networks in the disaster recovery site. VMs that are replicated with the cloud CDP policy will be connected to these networks.</p><p><strong>Note</strong>: The number of source networks must match the number of target networks.</p><p>Accepts the <code>VBRViNetworkInfo[]</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudservernetworkinfo.md"><code>VBRCloudServerNetworkInfo[]</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>
    </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
The cmdlet returns the `VBRCloudCDPPolicy` object that contains cloud CDP policy settings.

## Examples

::: example
### Creating Cloud CDP Policy

This example shows how to create the `DB_replication` cloud CDP policy.

```
$vm = Find-VBRViEntity -Name "DB server"
$host = Get-VBRCloudServer 
$datastore = Get-VBRCloudDatastore
Add-VBRCloudCDPPolicy -Entity $vm -Server $host[3] -Datastore $datastore[3] -Name "DB_replication"
```

Perform the following steps:

1. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vm` variable.
2. Run the [`Get-VBRCloudServer`](get-vbrcloudserver.md) cmdlet. Save the result to the `$host` variable.

   The `Get-VBRCloudServer` cmdlet will return an array of hosts. Mind the ordinal number of the necessary host (in our example, it is the fourth host in the array).

3. Run the [`Get-VBRCloudDatastore`](get-vbrclouddatastore.md) cmdlet. Save the result to the `$datastore` variable.

   The `Get-VBRCloudDatastore` cmdlet will return an array of datastores. Mind the ordinal number of the necessary datastore (in our example, it is the fourth datastore in the array).

4. Run the `Add-VBRCloudCDPPolicy` cmdlet. Specify the following settings:

   - Set the `$vm` variable as the `Entity` parameter value. 
   - Set the `$host` variable as the `Server` parameter value. 
   - Set the `$datastore` variable as the `Datastore` parameter value.
   - Specify the `Name` parameter value.

:::

## Related Commands

- [`Find-VBRViEntity`](find-vbrvientity.md)
- [`Get-VBRCloudServer`](get-vbrcloudserver.md)
- [`Get-VBRCloudDatastore`](get-vbrclouddatastore.md)