---
title: "Start-VBRCDPReplicaFailover"
description: "Starts to perform failover to VM replicas. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet starts to perform failover to VM replicas."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrcdpreplicafailover.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Continuous Data Protection (CDP) > CDP Failover > Start-VBRCDPReplicaFailover"
dateModified: "2026-08-19"
---

# Start-VBRCDPReplicaFailover

## Short Description
Starts to perform failover to VM 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>ToPointInTime (Default)</code></p>

```
Start-VBRCDPReplicaFailover -Replica <VBRCDPReplica> [-ToPointInTime <DateTime>] [-Reason <String>] [-Commit]
 [-PowerOn] [-Force] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>LongTermRestorePoint</code></p>

```
Start-VBRCDPReplicaFailover -Replica <VBRCDPReplica> -LongTermRestorePoint <VBRCDPLongTermRestorePoint>
 [-Reason <String>] [-Commit] [-PowerOn] [-Force] [-RunAsync] [-WhatIf]
 [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Planned</code></p>

```
Start-VBRCDPReplicaFailover -Replica <VBRCDPReplica> [-Planned] [-Reason <String>] [-Commit] [-PowerOn]
 [-Force] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts to perform failover to VM replicas.

::: important

Before you start to perform failover to VM replicas we recommend to the run the [`Get-VBRCDPShortTermRestoreInterval`](get-vbrcdpshorttermrestoreinterval.md) cmdlet to get a list of all replicated states that are available for VM replicas. This allows you to verify that you will not perform failover to replicated states of VM replicas that do not exist.

:::

## 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">Commit</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will perform permanent failover of the specified replicas in the failover state.</p><ul><li>If you provide this parameter, the cmdlet will permanently switch processes from the original VM to the VM protected with CDP and will set for the CDP replica a role of the original VM.</li><li>If you do not provide this parameter, the cmdlet will not set the CDP replica a role of the original VM after performing a failover.</li></ul>
        </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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will perform a failover without showing warnings in the PowerShell console.</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">LongTermRestorePoint</span></p>
        </td>
        <td>
          <p>Specifies a long-term restore point of a VM protected with CDP. The cmdlet will perform failover to this restore point.</p><p>Accepts the <code>VBRCDPLongTermRestorePoint</code> object. To get this object, run the <a href="get-vbrcdplongtermrestorepoint.md"><code>Get-VBRCDPLongTermRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCDPLongTermRestorePoint</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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 cmdlet will perform planned failover.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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 a CDP replica after performing failover. If you do not provide this parameter, the cmdlet will power on the replica. If you do not want to power on the replica, set the parameter to the <code>PowerOn:$false</code> value.</p><p>Default: <code>True</code>.</p><p><strong>Note</strong>: If you provide this parameter with the <code>Commit</code> parameter, the cmdlet will always start a replica.</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 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">Replica</span></p>
        </td>
        <td>
          <p>Specifies a VM protected with CDP to which you want to perform failover.</p><p>Accepts the <code>VBRCDPReplica</code> object. To create this object, run the <a href="get-vbrcdpreplica.md"><code>Get-VBRCDPReplica</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRCDPReplica</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</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">ToPointInTime</span></p>
        </td>
        <td>
          <p>Specifies a replicated state that is available for a VM protected with CDP.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</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>Defines that the cmdlet will write 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 CDP Replica Latest Restore Point

This example show how to perform a failover to the latest restore point. The cmdlet will perform a failover without without showing warnings in the PowerShell console.

```
$replica = Get-VBRCDPReplica -Name "Win05"
Start-VBRCDPReplicaFailover -Replica $replica -Force
```

Perform the following steps:

1. Run the [`Get-VBRCDPReplica`](get-vbrcdpreplica.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$replica` variable.
2. Run the `Start-VBRCDPReplicaFailover` cmdlet. Set the `$replica` variable as the `Replica` parameter. Provide the `Force` parameter.

:::

::: example
### Example 2. Performing Failover to CDP Replica Replicated State

This example shows to perform a failover to a specific replicated state of the CDP replica of the `Win05` VM.

```
$replica = Get-VBRCDPReplica -Name "Win05"
$restorepoints = Get-VBRCDPShortTermRestoreInterval -Replica $replica
$date = Get-Date -Year 2020 -Month 2 -Day 2 -Hour 0 -Minute 0 -Second 0
Start-VBRCDPReplicaFailover -Replica $replica -ToPointInTime $date
```

Perform the following steps:

1. Run the [`Get-VBRCDPReplica`](get-vbrcdpreplica.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$replica` variable.
2. Run the [`Get-VBRCDPShortTermRestoreInterval`](get-vbrcdpshorttermrestoreinterval.md) cmdlet. Specify the `Replica` parameter value. Check a list of all replicated states that are available for VM replicas.
3. Run the [`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1) cmdlet. Specify the `Year`, `Month`, `Day`, `Hour`, `Minute` and `Second` parameter values. Save the result to the `$date` variable.
4. Run the `Start-VBRCDPReplicaFailover` cmdlet. Set the `$replica` variable as the `Replica` parameter. Set the `$date` variable as the `ToPointInTime` parameter value.

:::

::: example
### Example 3. Performing Failover to CDP Replica Long-Term Restore Point

This example shows how to start to perform a failover to a specific long-term restore point of the CDP replica of the `Win05` VM.

```
$replica = Get-VBRCDPReplica -Name "Win05"
$restorepoint = Get-VBRCDPLongTermRestorePoint -Replica $replica -ApplicationConsistent
Start-VBRCDPReplicaFailover -Replica $replica -LongTermRestorePoint $restorepoint[0] -Force
```

Perform the following steps:

1. Run the [`Get-VBRCDPReplica`](get-vbrcdpreplica.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$replica` variable.
2. Run the [`Get-VBRCDPLongTermRestorePoint`](get-vbrcdplongtermrestorepoint.md) cmdlet. Specify the `Replica` and `ApplicationConsistent` parameter values. Save the result to the `$restorepoint` variable.
3. Run the `Start-VBRCDPReplicaFailover` cmdlet. Specify the following settings:

   - Set the `$replica` variable as the `Replica` parameter.
   - Set the `$restorepoint[0]` variable as the `LongTermRestorePoint` parameter.
   - Provide the `Force` parameter.

:::

## Related Commands

- [`Get-VBRCDPReplica`](get-vbrcdpreplica.md)
- [`Get-VBRCDPLongTermRestorePoint`](get-vbrcdplongtermrestorepoint.md)
- [`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1)