Add-VBRUniversalCDPPolicy

Short Description

Creates a universal CDP policy.

Applies to

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

Syntax

Add-VBRUniversalCDPPolicy -SourceObject <VBRUniversalCDPSource[]> -Destination <IUniversalCdpDestination> [-ExcludedObject <VBRUniversalCDPSource[]>] [-Name <string>] [-Description <string>] [-NetworkMapping <VBRUniversalCDPNetworkMappingRule[]>] [-SourceProxy <VBRCDPProxy[]>] [-TargetProxy <VBRCDPProxy[]>] [-Suffix <string>] [-CompressionLevel {None | DedupeFriendly | Optimal | High | Extreme}] [-NotificationOptions <VBRNotificationOptions>] [-RetentionOptions <VBRCDPPolicyRetentionOptions>] [<CommonParameters>]

Detailed Description

This cmdlet creates a universal CDP policy.

Note

The cmdlet creates a CDP policy in the disabled state unless you enable a policy schedule. Run the Enable-VBRCDPPolicy cmdlet to enable the policy.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

SourceObject

Specifies workloads or protection groups that you want to protect with universal CDP.

Accepts the VBRUniversalCDPSource[] object. To get this object, run the Get-VBRDiscoveredComputer or Get-VBRProtectionGroup cmdlet.

True

Named

True
(ByValue, ByPropertyName)

Destination

Specifies the settings of the target location where the workloads will be replicated.

Accepts the IUniversalCdpDestination object. To get this object, run the New-VBRUniversalCDPViDestination cmdlet.

True

Named

False

ExcludedObject

Specifies an array of workloads that you want to exclude from the universal CDP policy processing.

Accepts the VBRUniversalCDPSource[] object. To get this object, run the Get-VBRDiscoveredComputer cmdlet.

False

Named

False

Name

Specifies a name for the universal CDP policy.

String

False

Named

False

Description

Specifies a description for the universal CDP policy.

String

False

Named

False

NetworkMapping

Specifies an array of network mapping settings.

Accepts the VBRUniversalCDPNetworkMappingRule[] object. To get this object, run the New-VBRUniversalCDPNetworkMappingRule cmdlet.

False

Named

False

SourceProxy

Specifies an array of the source CDP proxies that you want to use.

Default: Automatic selection.

Accepts the VBRCDPProxy[] object. To get this object, run the Get-VBRCDPProxy cmdlet.

False

Named

False

TargetProxy

Specifies an array of the target CDP proxies that you want to use.

Default: Automatic selection.

Accepts the VBRCDPProxy[] object. To get this object, run the Get-VBRCDPProxy cmdlet.

False

Named

False

Suffix

Specifies the suffix that the cmdlet will add to the name of replicas.

Default: "_replica".

String

False

Named

False

CompressionLevel

Specifies the compression level of the replicated data:

  • None: use this option if you do not want to enable data compression.
  • Dedupe-friendly: use this option to set a dedupe-friendly compression level.
  • Optimal: use this option to set an optimal compression level.
  • High: use this option to set a high compression level.
  • Extreme: use this option to set an extreme compression level.

Default: Optimal.

VBRCompressionLevel

False

Named

False

NotificationOptions

Specifies notification settings of the universal CDP policy.

Accepts the VBRNotificationOptions object. To create this object, run the New-VBRNotificationOptions cmdlet.

False

Named

False

RetentionOptions

Specifies retention settings of the universal CDP policy.

Accepts the VBRCDPPolicyRetentionOptions object. To create this object, run the New-VBRCDPPolicyRetentionOptions cmdlet.

False

Named

False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRUniversalCDPPolicy object that defines settings of the universal CDP policy.

Examples

This example shows how to create the Universal CDP policy that will replicate the CDP Protection Group to the cluster.

$cluster = Find-VBRViEntity -Name "CDP cluster"

$server = Get-VBRServer -Name "prgtwesx01-virt.tech.local"

$pool = Find-VBRViEntity -Server $server -ResourcePools -Name Rep-Org-Ti*

$destination = New-VBRUniversalCDPViDestination -TargetCluster $cluster -ResourcePool $pool

$group = Get-VBRProtectionGroup -Name "Protection Group CDP"

$policy = Add-VBRUniversalCDPPolicy -SourceObject $group -Destination $destination -Name "Universal CDP Policy PS" -Description "Universal CDP for protection group"

Perform the following steps:

  1. Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $cluster variable.
  2. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
  3. Run the Find-VBRViEntity cmdlet. Set the $server variable as the Server parameter value. Specify the ResourcePools and Name parameter values. Save the result to the $pool variable.
  4. Run the New-VBRUniversalCDPViDestination cmdlet. Set the $cluster variable as the TargetCluster parameter value. Set the $pool variable as the ResourcePool parameter value. Save the result to the $destination variable.
  5. Run the Get-VBRProtectionGroup cmdlet. Specify the Name parameter value. Save the result to the $group variable.
  6. Run the Add-VBRUniversalCDPPolicy cmdlet. Specify the following settings:
  • Set the $group variable as the SourceObject parameter value.
  • Set the $destination variable as the Destination parameter value.
  • Specify the Name parameter value.
  • Specify the Description parameter value.
  • Save the result to the $policy variable.

Related Commands

Page updated 10/15/2025

Page content applies to build 13.0.1.180