---
title: "Start-VBRvCDCDPReplicaFailover"
description: "This cmdlet starts to perform failover to a Cloud Director CDP replica. The replica must be in the Ready state. Before you start to perform failover to Cloud Director CDP replicas we recommend to the run the Get-VBRvCDCDPShortTermRestoreInterval..."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrvcdcdpreplicafailover.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > CDP for VMware Cloud Director > Cloud Director CDP Failover > Start-VBRvCDCDPReplicaFailover"
dateModified: "2026-08-19"
---

# Start-VBRvCDCDPReplicaFailover

## Short Description
Starts to perform failover to a Cloud Director CDP replica.

**Product Edition**: 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-VBRvCDCDPReplicaFailover -Replica <VBRvCDCDPReplica> [-ToPointInTime <DateTime>] [-Reason <String>]
 [-Commit] [-Retry] [-PowerOn] [-Force] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestorePoint</code></p>

```
Start-VBRvCDCDPReplicaFailover -Replica <VBRvCDCDPReplica>
 -LongTermRestorePoint <VBRvCDCDPLongTermRestorePoint> [-Reason <String>] [-Commit] [-Retry] [-PowerOn]
 [-Force] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts to perform failover to a Cloud Director CDP replica. The replica must be in the *Ready* state.

::: important

Before you start to perform failover to Cloud Director CDP replicas we recommend to the run the [`Get-VBRvCDCDPShortTermRestoreInterval`](get-vbrvcdcdpshorttermrestoreinterval.md) cmdlet to get a list of all replicated states that are available for replicas. This allows you to verify that you do not perform failover to replicated states of 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 whether the cmdlet will perform permanent failover.</p><p>If you provide this parameter, the cmdlet will switch from the original vApp to the replica and will set for the replica the role of the original vApp.</p><p>If you do not provide this parameter, the cmdlet will not set for the replica the role of the original vApp after performing a failover.</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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will perform 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 replica. The cmdlet will perform failover to this restore point.</p><p>Accepts the <code>VBRvCDCDPLongTermRestorePoint</code> object. To get this object, run the <a href="get-vbrvcdcdplongtermrestorepoint.md"><code>Get-VBRvCDCDPLongTermRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRvCDCDPLongTermRestorePoint</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 the replica after performing failover. If you do not want to power on the replica, set the parameter to <code>$false</code>.</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 the 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 the replica to which you want to fail over.</p><p>Accepts the <code>VBRvCDCDPReplica</code> object. To get this object, run the <a href="get-vbrcdpreplicavcd.md"><code>Get-VBRCDPReplica</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRvCDCDPReplica</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">Retry</span></p>
        </td>
        <td>
          <p>Defines that if failover does not complete successfully, the cmdlet will start to perform failover again.</p><p>If you do not specify this parameter, the cmdlet will not start to perform failover if any vApps are in the incomplete state.</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">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 date and time when a restore point was created. The cmdlet will perform failover to the restore point created at the specified date and time.</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).

## Output Object
`SessionId <Guid>`

## Examples

::: example
### Example 1. Performing Failover to Restore Point Created at Specific Sate and Time

This example shows how to perform failover to a restore point created at a specific date and time.

```
$replica = Get-VBRCDPReplica -Name "Win07"
$date = Get-Date  -Year 2020 -Month 2 -Day 2 -Hour 0 -Minute 0 -Second 0
Start-VBRvCDCDPReplicaFailover -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-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.
3. Run the `Start-VBRvCDCDPReplicaFailover` cmdlet. Set the `$replica` variable as the `Replica` parameter value. Set the `$date` variable as the `ToPointInTime` parameter value.

:::

::: example
### Example 2.  Performing Failover to Specific Long-Term Restore Point Created of Cloud Director CDP Replica

This example shows how to perform failover to a specific long-term restore point of a Cloud Director CDP replica.

```
$replica = Get-VBRCDPReplica -Name "Win07"
$restorepoint = Get-VBRvCDCDPLongTermRestorePoint -Replica $replica
Start-VBRvCDCDPReplicaFailover -Replica $replica -LongTermRestorePoint $restorepoint
```

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-VBRvCDCDPLongTermRestorePoint`](get-vbrvcdcdplongtermrestorepoint.md) cmdlet. Set the `$replica` variable as the `Replica` parameter value. Save the result to the `$restorepoint` variable.
3. Run the `Start-VBRvCDCDPReplicaFailover` cmdlet. Set the `$replica` variable as the `Replica` parameter value. Set the `$restorepoint` variable as the `LongTermRestorePoint` parameter value.

:::

## Related Commands

- [`Get-VBRCDPReplica`](get-vbrcdpreplica.md)
- [`Get-Date`](get-hp3infrastructurevolume.md)
- [`Get-VBRvCDCDPLongTermRestorePoint`](get-vbrvcdcdplongtermrestorepoint.md)