---
title: "Start-VBRvCDReplicaFailover"
description: "This cmdlet starts to perform failover to a Cloud Director replica."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrvcdreplicafailover.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > VMware Cloud Director > Replication for VMware Cloud Director > Cloud Director Replica Failover > Start-VBRvCDReplicaFailover"
dateModified: "2026-08-19"
---

# Start-VBRvCDReplicaFailover

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

**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-VBRvCDReplicaFailover -RestorePoint <COib> [-Retry] [-Reason <String>] [-PowerOn] [-RunAsync] [-Force]
 [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Definitive</code></p>

```
Start-VBRvCDReplicaFailover -RestorePoint <COib> [-Definitive] [-Retry] [-Reason <String>] [-PowerOn]
 [-RunAsync] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts to perform failover to a Cloud Director replica.

## 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">Definitive</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will perform a permanent failover of a Cloud Director replica.</p><p>If you do not specify this parameter, the cmdlet will not switch permanently from the original vApp to a Cloud Director replica.</p><p><strong>Note</strong>: Before you perform permanent failover, make sure that your Cloud Director replica is in the <em>Failover</em> 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">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">PowerOn</span></p>
        </td>
        <td>
          <p>If set, the replica vApp will be powered on after the failback. Otherwise, you will need to power the vApp on 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 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 a restore point of a Cloud Director replica to which you want to perform failover.</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>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, Veeam Backup & Replication will start to perform failover to a Cloud Director replica again.</p><p>If you do not specify this parameter, the cmdlet will not start to perform failover to a Cloud Director replica if some VMs 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">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 Cloud Director Replica

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

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

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Provide the vApp name as the `Name` parameter value. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRvCDReplicaFailover` 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. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore point in the array).

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

:::

::: example
### Example 2. Performing Failover to Cloud Director Replica with Retry Option

This example shows how to perform failover to the `WebServer` Cloud Director replica. If failover does not complete successfully, Veeam Backup & Replication will start to perform failover to a Cloud Director replica again.

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

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Provide the vApp name as the `Name` parameter value. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRvCDReplicaFailover` 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. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore point in the array).

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

::: important

Before you perform permanent failover, make sure that your Cloud Director replica is in the *Failover* state.

:::

:::

::: example
### Example 3. Performing Permanent Failover to Cloud Director Replica

This example shows how to perform a permanent failover to the `WebServer` Cloud Director replica.

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

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Provide the vApp name as the `Name` parameter value. Save the result to the `$restorepoint` variable.
2. Run the `Start-VBRvCDReplicaFailover` 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. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore point in the array).

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

:::

## Related Commands

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