Start-VBRCDPReplicaFailback

In this article

    Short Description

    Starts to perform a failback from a CDP replica to the production VM.

    Applies toc

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

    Syntax

    This cmdlet provides cmdlet sets that allow you to:

    • Starts to perform a failback from a CDP replica to the original VM.

    Start-VBRCDPReplicaFailback -Replica <VBRCDPReplica> [-DRProxy <VBRCDPProxy[]>] [-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-SwitchingSchedule <VBRFailbackSwitchingSchedule>] [-Reason <string>][-PowerOn] [-IncludeTags] [-QuickRollback] [-RunAsync] [-Force] [-WhatIf] [-Confirm]  [<CommonParameters>]

    • Starts to perform a failback from a CDP replica to the original VM that is restored in a different location.

    Start-VBRCDPReplicaFailback -Replica <VBRCDPReplica> -DestinationVM <CViVmItem> [-DRProxy <VBRCDPProxy[]>] [-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-SwitchingSchedule <VBRFailbackSwitchingSchedule>] [-Reason <string>] [-PowerOn] [-IncludeTags] [-RunAsync] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

    • Starts to perform a failback from a CDP replica to the production VM in a different location or with different settings.

    Start-VBRCDPReplicaFailback -Replica <VBRCDPReplica> -Server <CHost> [-DRProxy <VBRCDPProxy[]>] [-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-SwitchingSchedule <VBRFailbackSwitchingSchedule>] [-Reason <string>] [-PowerOn] [-ResourcePool <CViResourcePoolItem>] [-Folder <CViFolderItem>] [-Datastore <VBRViDatastoreBase>] [-DRNetwork <VBRViNetworkInfo[]>] [-ProductionNetwork <VBRViNetworkInfo[]>] [-IncludeTags] [-RunAsync] [-Force] [-WhatIf] [-Confirm]  [<CommonParameters>]

    Detailed Description

    This cmdlet starts to perform a failback from CDP replica to the production VM. The CPD replica must be in the failover status. After you start to commit a failback, the cmdlet switches the status of the CDP replica from the Fialover state to the Ready to switch state.

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    Replica

    Specifies a CDP replica from which you want to perform a failback.

    Accepts the VBRCDPReplica object. To create this object, run the Get-VBRCDPReplica cmdlet.

    True

    Named

    True (ByValue, ByPropertyName)

    DestinationVM

    For performing a failback to a different location.

    Specifies an original VM that is restored in a different location. The cmdlet will perform failback from a CDP replica to this VM.

    Accepts the CViVmItem object. To get this object, run the Find-VBRViEntity cmdlet.

    True

    Named

    False

    Server

    For performing a failback to a different location or with different settings.

    Specifies an ESXi host. The cmdlet will perform a failover of CDP replica to an original VM that is located on this ESXi host.

    Accepts the CHost object. To get this object, run the Find-VBRViEntity cmdlet.

    True

    Named

    False

    DRProxy

    Specifies an array of VMware CDP proxies that are configured on the disaster recovery site.

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

    False

    Named

    False

    ProductionProxy

    Specifies an array of VMware CDP proxies that are configured on the production site.

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

    False

    Named

    False

    Complete

    Defines that the cmdlet will switch the CDP replica from the failback state to the permanent failback state.

    SwitchParameter

    False

    Named

    False

    SwitchToProduction

    Defines that the cmdlet will switch the CDP replica from the ready to switch state to the failback state.

    SwitchParameter

    False

    Named

    False

    SwitchingSchedule

    Specifies a switching schedule for CDP replica. The cmdlet will switch the replica to the production VM according to this schedule.

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

    False

    Named

    False

    Reason

    Specifies the reason for performing a failback.

    String

    False

    Named

    False

    ResourcePool

    For failback to a different location.

    Specifies a resource pool. The cmdlet will perform a failback of CDP replica to an original VM that is located on this resource pool.

    If you do not specify this parameter, the cmdlet will use the resource pool that is set as a default for the target host.

    Accepts the CViResourcePoolItem object. To get this object, run the Find-VBRViEntity cmdlet.

    False

    Named

    False

    Folder

    For failback to a different location.

    Specifies a folder. The cmdlet will perform a failback of CDP replica to an original VM that is located in this folder.

    If you do not specify this parameter, the cmdlet will use the folder that is set as a default for the target host.

    Accepts the CViFolderItem object. To get this object, run the Find-VBRViEntity cmdlet.

    False

    Named

    False

    Datastore

    For failback to a different location.

    Specifies the datastore. The cmdlet will perform a failback of CDP replica to an original VM that is located on this datastore.

    If not specified, the cmdlet will use the datastore that is set as default for the target host.

    Accepts the VBRViDatastoreBase object. To get this object, run the Find-VBRViEntity cmdlet.

    False

    Named

    False

    DRNetwork

    For failback to a different location.

    Specifies an array of disaster recovery site networks. The cmdlet will map the replica to these networks.

    Note: If you specify this parameter, you must also specify the ProductionNetwork parameter.

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

    False

    Named

    False

    ProductionNetwork

    For failback to a different location.

    Specifies an array of production site networks. The cmdlet will map the replica to these networks.

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

    False

    Named

    False

    PowerOn

    Defines that the cmdlet will power on the production VM after the failback. If you do not provide this parameter, you will need to power the VM on manually.

    SwitchParameter

    False

    Named

    False

    IncludeTags

    Defines that the cmdlet will restore VMs with their VMware tags. If you do not provide this paramer,  the cmdlet will restore VMs without their VMware tag.

    SwitchParameter

    False

    Named

    False

    QuickRollback

    Defines that the cmdlet will perform incremental failback.

    Note: Incremental failback uses VM changed block tracking data. If the cmdlet fails to retrieve the changed block tracking data for some reason, it will perform full VM failback.

    SwitchParameter

    False

    Named

    False

    RunAsync

    Defines that the command returns immediately without waiting for the task to complete.

    Note: This parameter cannot be used if you set the failback switch schedule by running the New-VBRFailbackSwitchingSchedule cmdlet to the Auto or Scheduled types.

    SwitchParameter

    False

    Named

    False

    Force

    Defines that the cmdlet will to fail back without showing warnings in the PowerShell console.

    SwitchParameter

    False

    Named

    False

    WhatIf

    Defines that the cmdlet will write a message that describes the effects of running the cmdlet without actually performing any action.

    SwitchParameter

    False

    Named

    False

    Confirm

    Defines that the cmdlet will display a prompt that asks if you want to continue running the command.

    SwitchParameter

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Output Object

    None.

    Examples

    Start-VBRCDPReplicaFailbackExample 1. Performing Failback from CDP Replica to Orignal VM

    This example shows how to perform a failback from the Win05_replicant CDP replica to the original VM with the following settings:

    • The cmdlet will use the Proxy05, Proxy07, Proxy09 machines as VMware CDP proxies that are configured on the disaster recovery site.
    • The cmdlet will use the Proxy12, Proxy13, Proxy15 machines as  VMware CDP proxies that are configured on the production site.

    $replica = Get-VBRCDPReplica -Name "Win05_replicant"

    $DRproxy = Get-VBRCDPProxy -Name "Proxy05, Proxy07, Proxy09"

    $prodproxy = Get-VBRCDPProxy -Name "Proxy12, Proxy13, Proxy15"

    Start-VBRCDPReplicaFailback -Replica $replica -DRProxy $DRproxy -ProductionProxy $prodproxy

    Perform the following steps:

    1. Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
    2. Run the Get-VBRCDPProxy cmdlet. Save the result to the $DRproxy variable.
    3. Run the Get-VBRCDPProxy cmdlet. Save the result to the $prodproxy variable.
    4. Run the Start-VBRCDPReplicaFailback cmdlet. Specify the following settings:
    • Set the $replica variable as the Replica parameter value.
    • Set the $DRproxy variable as the DRProxy parameter value.
    • Set the $prodproxy variable as the ProductionProxy parameter value.

    Start-VBRCDPReplicaFailbackExample 2. Performing Failback from CDP Replica to Different Location

    This example shows how to perform a failback from the Win05_replicant CDP replica to the Win05_Prod original VM. This VM is restored on the ESXiHost 04 ESXi host.

    $replica = Get-VBRCDPReplica -Name "Win05_replicant"

    $server = Get-VBRServer -Name "ESXiHost 04"

    $originalvm = Find-VBRViEntity -Server $server -Name "Win05_Prod"

    Start-VBRCDPReplicaFailback -Replica $replica -DestinationVM $originalvm

    Perform the following steps:

    1. Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
    2. Get the original VM:
    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    2. Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $originalvm variable.
    1. Run the Stop-VBRCDPReplicaFailback cmdlet. Set the $replica variable as the Replica parameter value. Set the $originalvm variable as the DestinationVM parameter value.

    Start-VBRCDPReplicaFailbackExample 3. Performing Failback from CDP Replica with Different Settings

    This example shows how to perform a failback from the Win05_replicant CDP replica to the Win07_Prod production VM. The Win07_Prod VM is restored to the Resources resource pool and the ProductionRestored folder.

    $server = Get-VBRServer -Name "ESXiHost 03"

    $pool = Find-VBRViEntity -Server $server -ResourcePools -Name "Resources"

    $folder = Find-VBRViEntity -Server $server  -Name "ProductionRestored"

    Start-VBRCDPReplicaFailback -Replica $replica -Server $server -ResourcePool $pool -Folder $folder

    Perform the following steps:

    1. Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
    2. Get the resource pool and the folder:
    1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
    2. Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $pool variable.
    3. Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $folder variable.
    1. Run the Stop-VBRCDPReplicaFailback cmdlet. Specify the following settings:
    • Set the $replica variable as the Replica parameter value.
    • Set the $server variable as the Server parameter value.
    • Set the $pool variable as the ResourcePool parameter value.
    • Set the $folder variable as the Folder parameter value.

    Related Commands