Removes a CDP replica from the configuration database or disk.
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Remove-VBRCDPReplica -Replica <VBRCDPReplicaBase> [-FromDisk] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
This cmdlet removes a CDP replica including CDP replicas created by CDP policies including Cloud Director CDP policies, CDP policies, cloud CDP policies and so on.
You can remove the replica according to the following scenarios:
- From the configuration. Veeam Backup & Replication removes records about the replicas from the configuration database, stops showing the replicas in Veeam Backup & Replication console and also stops synchronizing their state with the state of the original workload. However, the actual replicas remain on hosts.
- From the disk. Veeam Backup & Replication removes the replicas not only from the Veeam Backup & Replication console and configuration database, but also from the host storage.
Accept Pipeline Input
Specifies the replica that you want to remove.
Accepts the VBRCDPReplicaBase object. To create this object, run the Get-VBRCDPReplica cmdlet.
True (ByValue, ByPropertyName)
Defines that the cmdlet will remove the replica from the disk.
Note: If you do not provide this parameter, the cmdlet will remove the replica from the configuration.
Defines that the cmdlet will remove a replica showing warnings in the PowerShell console.
Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.
Defines that the cmdlet will display a prompt that asks if you want to continue running the command.
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.
Removing CDP Replica from Backup Infrastructure
This examples shows how to remove the Win05_replicant CDP replica from a backup infrastructure. The cmdlet will permanently remove a CDP replica from a disk.
$replica = Get-VBRCDPReplica -Name "Win05_replicant"
Remove-VBRCDPReplica -Replica $replica -FromDisk
Perform the following steps:
- Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
- Run the Remove-VBRCDPReplica cmdlet. Set the $replica variable as the Replica parameter. Provide the FromDisk parameter.