This is an archive version of the document. To get the most up-to-date information, see the current version.

Start-VBRViReplicaFailback

On This Page

Short Description
Applies to
Syntax
Detailed Description
Parameters
Example 1
Example 2

Short Description

Fails back to production host.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

Start-VBRViReplicaFailback -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Complete] [-PowerOn] [-SkipTagsRestore] [-DRSiteProxy <CViProxy[]>] [-ProdSiteProxy <CViProxy[]>] [-StoragePolicyAction <VBRStoragePolicyAction> {Current | Stored | Default}] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Get-VBRRestorePoint

Get-VBRViProxy

Detailed Description

This cmdlet stars failing back to the production host after failover to its replica.

This cmdlet lets you finalize the replica failover started with Start-VBRViReplicaFailover by switching back to the production VM with data synchronization.

When you perform failback, you switch back to the original VM on the production site. The failback process collects all the changes that were made to the replica while you failed over to it, and implies them to the source VM. This allows you to switch between source and replica VMs without data loss.

To switch back to the production VM and discard the changes made to the replica while failover, start an undo failover process. In this case you return to the production VM in the state preceeding failover. Run Stop-VBRReplicaFailover to undo failover.

Undo Failback: If you tried to fail back to the original VM but was unable to, because i.e. it was non-functional or corrupted, you can undo the failback and return to the working replica. Run Stop-VBRViReplicaFailback to undo failback.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
RestorePoint	Specifies the replica restore point which you want to fail back.	True	Named	True (ByValue, ByProperty Name)	False
Reason	Specifies the reason for performing a failback.	False	Named	False	False
RunAsync	Indicates that the command returns immediately without waiting for the task to complete.	False	Named	False	False
Complete	If set, the failback will be committed.	False	Named	False	False
PowerOn	If set, the production VM will be powered on after the failback. Otherwise, you will have to power the VM on manually.	False	Named	False	False
Skip Tags Restore	If set, the VM will be restored without its VMware tag. Otherwise, the restored VM will keep its original tag.	False	Named	False	False
DRSite Proxy	Specifies the proxy configured on the disaster recovery site.	False	Named	False	False
ProdSite Proxy	Specifies the proxy configured on the production site.	False	Named	False	False
Storage Policy Action	Specifies the strategy for selecting storage policy profile in case the storage profile of the backed up VM differs from the profile of the original VM. Current: the restored VM will be subscribed to the same profile as in backup (if such profile still exists) or to the profile to which the original VM is subscribed (if profile as in backup was removed). Default: the restored VM will be subscribed to the profile that is set as default for the target datastore. Stored: the restored VM will be subscribed to the profile as in backup (if such profile still exists).	False	Named	False	False
WhatIf	Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.	False	Named	False	False
Confirm	Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.	False	Named	False	False

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Example 1

This command fails back from the VM replica named "WebServer_ replica". The restore point is obtained with Get-VBRRestorePoint and piped down. The restore points of the VM are filtered with Sort-Object method by the "creationtime" property to get the most recent one. The reason is "Configuration recovery". The RunAsync parameter is set to bring the process to the background.

PS C:\PS> Get-VBRRestorePoint -Name "WebServer_replica" | Sort-Object $_.creationtime -Descending | Select -First 1 | Start-VBRViReplicaFailback -Reason "Configuration recovery" -RunAsync

Example 2

This command fails back from the VM replica represented by the $"WebServer 01_replica restorepoint" variable. The restore point is obtained with Get-VBRRestorePoint and assigned to the variable beforehand. The reason is "Data recovery". The RunAsync parameter is set to bring the process to the background.

PS C:\PS> Start-VBRViReplicaFailback -RestorePoint $"WebServer_replica restorepoint" -Reason "Data recovery" -RunAsync