This is an archive version of the document. To get the most up-to-date information, see the current version.Start-VBRHvReplicaFailover
Short Description
Fails over a corrupted VM to its replica.
Applies to
Platform: Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus
Syntax
Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync] [<CommonParameters>] -OR- Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync] [-Definite] [<CommonParameters>] -OR- Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync] [-Planned] [<CommonParameters>] |
Related Commands
Detailed Description
This cmdlet allows you fail over a corrupted VM to its successfully created replica.
Performing failover is switching to a VM replica in case the original VM is damaged. You can fail over to the latest state of a replica or to any of its good known restore points.
In Veeam Backup & Replication, failover is a temporary stage that needs to be finalized:
- You can perform failback to recover the original VM on the source host or in a new location. Failback is used in case you failed over to a DR site that is not intended for continuous operations, and would like to move the operations back to the production site when the consequences of a disaster are eliminated.
Run Start-VBRHvReplicaFailback to failback to the original VM.
- You can undo failover to switch back to the original VM, revert replication operations and discard changes made to the working VM replica. In this case you loose all the changes that were made to the replica while you failed over to it.
Run Stop-VBRReplicaFailover to undo failover. You can also undo planned failover.
Parameters
Parameter | Description | Required | Position | Accept | Accept |
Restore | Specifies the replica restore point to which you want to fail over. | True | 1 | True (ByValue, | False |
Reason | Specifies the reason for performing a failover. | False | Named | False | False |
RunAsync | Indicates that the command returns immediately without waiting for the task to complete. | False | Named | False | False |
Definite | Performs permanent failover. | False | Named | False | False |
Planned | Performs planned failover. | False | Named | False | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.