Start-VBRHvReplicaFailover
Short Description
Fails over corrupted Hyper-V VMs to their replicas.
Applies to
Platform: Hyper-V
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
This cmdlet provides parameter sets that allow you to:
- Perform failover.
- Perform permanent failover.
Start-VBRHvReplicaFailover -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Definite] [<CommonParameters>] |
- Perform planned failover.
Start-VBRHvReplicaFailover -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Planned] [<CommonParameters>] |
Detailed Description
This cmdlet fails over a corrupted Hyper-V VM to its successfully created replica.
This cmdlet provides 3 parameter sets for the following operations:
- Failover
- Permanent failover
- Planned failover
Run the Start-VBRHvReplicaFailback cmdlet to fail back to the original VM.
Run the Stop-VBRReplicaFailover cmdlet to undo failover. You can also undo planned failover.
Parameters
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|---|---|---|---|---|
RestorePoint | Specifies the replica restore point to which you want to fail over. | Accepts the COib object. To get this object, run the Get-VBRRestorePoint cmdlet. | True | 1 | True (ByValue, |
Reason | Specifies the reason for performing a failover. | String | False | Named | False |
RunAsync | Defines that the command returns immediately without waiting for the task to complete. | SwitchParameter | False | Named | False |
Definite | Defines that the failover is permanent. | SwitchParameter | False | Named | False |
Planned | Defines that the failover is planned. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
None.
Examples
Example 1. Performing Planned Failover to VM Replica
Example 2. Performing Permanent Failover to VM Replica
Related Commands
