---
title: "Start-VBRHvReplicaFailover"
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..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrhvreplicafailover.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Replication > Failover and Failback > Start-VBRHvReplicaFailover"
dateModified: "2026-08-19"
---

# Start-VBRHvReplicaFailover

## Short Description
Fails over corrupted Hyper-V VMs to their replicas.

**Platform**: Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Definite</code></p>

```
Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [-Definite] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Planned</code></p>

```
Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [-Planned] [<CommonParameters>]
```
  </li>
</ul>

## 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`](start-vbrhvreplicafailback.md) cmdlet to fail back to the original VM.

Run the [`Stop-VBRReplicaFailover`](stop-vbrreplicafailover.md) cmdlet to undo failover. You can also undo planned failover.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Definite</span></p>
        </td>
        <td>
          <p>Defines that the failover is permanent.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Planned</span></p>
        </td>
        <td>
          <p>Defines that the failover is planned.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Reason</span></p>
        </td>
        <td>
          <p>Specifies the reason for performing a failover.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies the replica restore point to which you want to fail over.</p><p>Accepts the <code>COib</code> object. To get this object, run the <a href="get-vbrrestorepoint.md"><code>Get-VBRRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>COib</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Examples

::: example
### Example 1. Performing Planned Failover to VM Replica

This example shows how to perform failover to the `Hyper-V WebServer` VM replica.

```
$restorepoint = Get-VBRRestorePoint -Name "Hyper-V WebServer"
Start-VBRHvReplicaFailover -RestorePoint $restorepoint[1] -Reason "Data recovery" -RunAsync -Planned
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRHvReplicaFailover` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.

     The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the second restore point is used.

   - Specify the `Reason` parameter value.
   - Provide the `RunAsync` parameter.
   - Provide the `Planned` parameter.

:::

::: example
### Example 2. Performing Permanent Failover to VM Replica

This example shows how to perform failover to the `Hyper-V WebServer` VM replica.

```
$restorepoint = Get-VBRRestorePoint -Name "Hyper-V WebServer"
Start-VBRHvReplicaFailover -RestorePoint $restorepoint[3] -Reason "Data recovery" -RunAsync -Definite
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRHvReplicaFailover` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.

     The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Consider that the array numbering starts with 0. In our example, the fourth restore point is used.

   - Specify the `Reason` parameter value.
   - Provide the `RunAsync` parameter.
   - Provide the `Definite` parameter.

:::

## Related Commands

[`Get-VBRRestorePoint`](get-vbrrestorepoint.md)