---
title: "Start-VBRViReplicaFailover"
description: "Fails over corrupted VMware VMs to their replicas. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: Failover (Default) Planned Definite This cmdlet fails over a corrupt"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrvireplicafailover.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Replication > Failover and Failback > Start-VBRViReplicaFailover"
dateModified: "2026-08-19"
---

# Start-VBRViReplicaFailover

## Short Description
Fails over corrupted VMware VMs to their replicas.

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

## Syntax

This cmdlet provides the following parameter sets:

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

```
Start-VBRViReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [-PowerOn] [-ReIp]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Planned</code></p>

```
Start-VBRViReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [-PowerOn] [-Planned]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Definite</code></p>

```
Start-VBRViReplicaFailover [-RestorePoint] <COib> [-Reason <String>] [-RunAsync] [-Definite]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet fails over a corrupted VMware VM to its successfully created replica.

Run the [`Start-VBRViReplicaFailback`](start-vbrvireplicafailback.md) cmdlet to fail back to the original VM.

Run the [`Stop-VBRReplicaFailover`](stop-vbrreplicafailover.md) cmdlet to undo 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><p>Default: The planned failover option is enabled.</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">PowerOn</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will power on replica VM after the failover. Otherwise, you will need to power on the replica VM manually.</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">ReIp</span></p>
        </td>
        <td>
          <p>Defines that the replica will use the re-IP rules that are set in the replication job.</p><p><strong>Note</strong>: Do not enable the re-IP if the re-IP rules are not configured in the replication job.</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">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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Confirm</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will display a prompt that asks if you want to continue running the command.</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">WhatIf</span></p>
        </td>
        <td>
          <p>Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.</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 Failover to VM Replica

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

```
$restorepoint = Get-VBRRestorePoint -Name "WebServer"
Start-VBRViReplicaFailover -RestorePoint $restorepoint[3] -Reason "Data recovery" -RunAsync
```

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-VBRViReplicaFailover` 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.

:::

::: example
### Example 2. Performing Failover to Latest Restore Point [Using Pipeline]

This command fails over to the latest restore point of the `WebServer` VM replica.

```
Get-VBRRestorePoint -Name "WebServer" | Sort-Object $_.creationtime -Descending | Select-Object -First 1 | Start-VBRViReplicaFailover -Reason "Configuration recovery" -RunAsync
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value.
2. Pipe the cmdlet output to the [`Sort-Object`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/sort-object?view=powershell-7) cmdlet. Set the `.creationtime` property for the `$_ variable`. Provide the `Descending` parameter.
3. Pipe the cmdlet output to the [`Select-Object`](https://docs.microsoft.com/en-us/powershell/module/Microsoft.PowerShell.Utility/Select-Object?view=powershell-7) cmdlet. Set the `1` number as the `First` parameter value.
4. Pipe the cmdlet output to the `Start-VBRViReplicaFailover` cmdlet. Specify the `Reason` parameter value. Provide the `RunAsync` parameter.

:::

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

This example shows how to perform planned failover of the `WebServer` VM.

```
$restorepoint = Get-VBRRestorePoint -Name "WebServer"
Start-VBRViReplicaFailover -RestorePoint $restorepoint[3] -Reason "Tsunami forecast" -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-VBRViReplicaFailover` 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 `Planned` parameter.

:::

::: example
### Example 4. Performing Permanent Failover

This example shows how to perform permanent failover of the `WebServer` VM.

```
$restorepoint = Get-VBRRestorePoint -Name "WebServer"
Start-VBRViReplicaFailover -RestorePoint $restorepoint[3] -Reason "Configuration 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-VBRViReplicaFailover` 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)
- [`Sort-Object`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/sort-object?view=powershell-7)
- [`Select-Object`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/select-object?view=powershell-7)