Start-VBRvCDCDPReplicaFailback

Short Description

Starts to perform failback from a Cloud Director CDP replica to the production vApp.

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

ToOriginal (Default)

Start-VBRvCDCDPReplicaFailback -Replica <VBRvCDCDPReplica> [-DRProxy <VBRCDPProxy[]>]

[-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-Retry]

[-SwitchingSchedule <VBRFailbackSwitchingSchedule>] [-Reason <String>] [-PowerOn] [-RunAsync] [-Force]

[-WhatIf] [-Confirm] [<CommonParameters>]

DifferentLocation

Start-VBRvCDCDPReplicaFailback -Replica <VBRvCDCDPReplica> [-DRProxy <VBRCDPProxy[]>]

[-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-Retry]

[-SwitchingSchedule <VBRFailbackSwitchingSchedule>] -DestinationvApp <CVcdVappItem> [-Reason <String>]

[-PowerOn] [-RunAsync] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

SpecifiedLocation

Start-VBRvCDCDPReplicaFailback -Replica <VBRvCDCDPReplica> [-DRProxy <VBRCDPProxy[]>]

[-ProductionProxy <VBRCDPProxy[]>] [-Complete] [-SwitchToProduction] [-Retry]

[-SwitchingSchedule <VBRFailbackSwitchingSchedule>] -OrganizationvDC <CVcdOrganizationVdcItem>

[-DestinationVAppName <String>] [-StoragePolicy <CVcdOrgVdcStorageProfile>]

[-DRNetwork <VBRvCDOrgVdcNetworkInfo[]>] [-ProductionNetwork <VBRvCDOrgVdcNetworkInfo[]>] [-Reason <String>]

[-PowerOn] [-RunAsync] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

This cmdlet starts to perform failback from a Cloud Director CDP replica to the production vApp. The replica must be in the Failover state. After you start to commit failback, the cmdlet switches the state of the replica from Failover to Ready to switch.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Complete	Defines that the cmdlet will commit failback.	`SwitchParameter`	False	Named	False
DestinationvApp	For performing failback to an already recovered vApp in a different location. Specifies the original vApp that is restored in a different location. The cmdlet will perform failback from the replica to this vApp. Accepts the `CViVmItem` object. To get this object, run the `Find-VBRViEntity` cmdlet.	`CVcdVappItem`	True	Named	False
DestinationVAppName	For performing failback to a different location or with different settings. Specifies a name for the vApp that will be restored from the specified replica. The cmdlet will create a vApp with this name and will perform failback to this vApp.	`String`	False	Named	False
DRNetwork	For performing failback to a different location or with different settings. Specifies an array of networks in the disaster recovery site to which replica is connected. The cmdlet will map these networks to the networks in the production site. Note: If you specify this parameter, you must also specify the `ProductionNetwork` parameter. Accepts the `VBRvCDOrgVdcNetworkInfo`[] object. To get this object, run the `Get-VBRVCDOrgVdcNetworkInfo` cmdlet.	`VBRvCDOrgVdcNetworkInfo[]`	False	Named	False
DRProxy	Specifies an array of CDP proxies that are configured in the disaster recovery site and that will be used for failback. Accepts the `VBRCDPProxy[]` object. To get this object, run the `Get-VBRCDPProxy` cmdlet.	`VBRCDPProxy[]`	False	Named	False
Force	Defines that the cmdlet will fail back without showing warnings in the PowerShell console.	`SwitchParameter`	False	Named	False
OrganizationvDC	For performing failback to a different location or with different settings. Specifies the organization VDC where you want to restore the vApp from the specified replica. Accepts the `CVcdOrganizationVdcItem` object. To get this object, run the `Find-VBRvCloudEntity` cmdlet.	`CVcdOrganizationVdcItem`	True	Named	False
PowerOn	Defines that the cmdlet will power on the production vApp after failback. If you do not provide this parameter, you will need to power on VMs in the vApp manually. Default: `False.` Note: If you provide this parameter with the `Complete` parameter, this parameter will not work. The VMs in the vApp will remain in the state it had before committing failback.	`SwitchParameter`	False	Named	False
ProductionNetwork	For performing failback to a different location or with different settings. Specifies an array of networks in the production site. The cmdlet will restore the vApp from the specified replica and will map the replica networks to these networks. Note: If you specify this parameter, you must also specify the `DRNetwork` parameter. Accepts the `VBRvCDOrgVdcNetworkInfo`[] object. To get this object, run the `Get-VBRVCDOrgVdcNetworkInfo` cmdlet.	`VBRvCDOrgVdcNetworkInfo[]`	False	Named	False
ProductionProxy	Specifies an array of CDP proxies that are configured in the production site and that will be used for failback. Accepts the `VBRCDPProxy[]` object. To get this object, run the `Get-VBRCDPProxy` cmdlet.	`VBRCDPProxy[]`	False	Named	False
Reason	Specifies the reason for performing failback.	`String`	False	Named	False
Replica	Specifies the replica from which you want to fail back. Accepts the `VBRvCDCDPReplica` object. To get this object, run the `Get-VBRCDPReplica` cmdlet.	`VBRvCDCDPReplica`	True	Named	True (ByPropertyName, ByValue)
Retry	Defines that if failback does not complete successfully, the cmdlet will start to perform failback to a replica again. If you do not specify this parameter, the cmdlet will not start to perform failback if any vApps are in the incomplete state.	`SwitchParameter`	False	Named	False
RunAsync	Defines that the command returns immediately without waiting for the task to complete. Note: This parameter can be used if you set the failback switch schedule by running the `New-VBRFailbackSwitchingSchedule` cmdlet to the `Manual` type.	`SwitchParameter`	False	Named	False
StoragePolicy	For performing failback to a different location or with different settings. Specify the storage policy that you want to apply to the production vApp after performing failback. Accepts the `CVcdOrgVdcStorageProfile` object. To get this object, run the `Find-VBRvCloudEntity` cmdlet.	`CVcdOrgVdcStorageProfile`	False	Named	False
SwitchingSchedule	Specifies a switching schedule. The cmdlet will switch the replica to the production vApp according to this schedule. Accepts the `VBRFailbackSwitchingSchedule` object. To create this object, run the `New-VBRFailbackSwitchingSchedule` cmdlet.	`VBRFailbackSwitchingSchedule`	False	Named	False
SwitchToProduction	Defines that the cmdlet will switch the replica from the Ready to switch state to the Failback state.	`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
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

<CommonParameters>

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

Output Object

SessionId <Guid>

Examples

Start-VBRvCDCDPReplicaFailback Example 1. Performing Failback from Cloud Director CDP Replica to Original vApp

This example shows how to start to perform failback from a Cloud Director CDP replica to the original vApp.

$replica = Get-VBRCDPReplica -Name "Win07"

Start-VBRvCDCDPReplicaFailback -Replica $replica

Perform the following steps:

Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
Run the Start-VBRvCDCDPReplicaFailback cmdlet. Set the $replica variable as the Replica parameter value.

Start-VBRvCDCDPReplicaFailback Example 2. Performing Failback from Cloud Director CDP Replica to Original vApp in New Location

This example shows how to start to perform failback from a Cloud Director CDP replica to the original vApp that is already recovered to a new location.

$replica = Get-VBRCDPReplica -Name "Win07"

$server = Get-VBRServer -Name "Cloud Server"

$vapp = Find-VBRvCloudEntity -Server $server -VApp

Start-VBRvCDCDPReplicaFailback -Replica $replica -DestinationvApp $vapp

Perform the following steps:

Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Find-VBRvCloudEntity cmdlet. Specify the Server and VApp parameters values. Save the result to the $vapp variable.
Run the Start-VBRvCDCDPReplicaFailback cmdlet. Set the $replica variable as the Replica parameter value. Set the $vapp variable as the DestinationvApp parameter value.

Start-VBRvCDCDPReplicaFailback Example 3. Performing Failback from Cloud Director CDP Replica to Different Location

This example shows how to start to perform failback from a Cloud Director CDP replica to a different location.

$replica = Get-VBRCDPReplica -Name "Win07"

$server = Get-VBRServer -Name "Cloud Server"

$organization = Find-VBRvCloudEntity -Server $server -OrganizationVdc

Start-VBRvCDCDPReplicaFailback -Replica $replica -OrganizationvDC $organization

Perform the following steps:

Run the Get-VBRCDPReplica cmdlet. Specify the Name parameter value. Save the result to the $replica variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Find-VBRvCloudEntity cmdlet. Specify the Server and OrganizationVdc parameters values. Save the result to the $organization variable.
Run the Start-VBRvCDCDPReplicaFailback cmdlet. Set the $replica variable as the Replica parameter value. Set the $organization variable as the OrganizationvDC parameter value.