---
title: "Add-VBRFailoverPlan"
description: "Creates failover plans or cloud failover plans. Platform: VMware, Hyper-V Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: FailoverPlanObject CloudFailoverPlanObject This cmdlet "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbrfailoverplan.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Replication > Failover Plans > Add-VBRFailoverPlan"
dateModified: "2026-08-19"
---

# Add-VBRFailoverPlan

## Short Description
Creates failover plans or cloud failover plans.

**Platform**: VMware, Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>FailoverPlanObject</code></p>

```
Add-VBRFailoverPlan -Name <String> [-Description <String>] -FailoverPlanObject <VBRFailoverPlanObject[]>
 [-PrefailoverCommand <String>] [-PostfailoverCommand <String>] [-EnablePublicIpRule] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>CloudFailoverPlanObject</code></p>

```
Add-VBRFailoverPlan -Name <String> [-Description <String>]
 -CloudFailoverPlanObject <VBRCloudFailoverPlanObject[]> [-PrefailoverCommand <String>]
 [-PostfailoverCommand <String>] [-EnablePublicIpRule] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the following types of failover plans:

- Failover plan
- Cloud failover plan

## 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">CloudFailoverPlanObject</span></p>
        </td>
        <td>
          <p>Specifies the array of VMs replicated to cloud. These VMs will be added to the cloud failover plan.</p><p>Accepts the <a href="vbrcloudfailoverplanobject.md"><code>VBRCloudFailoverPlanObject[]</code></a> object. To get this object, run the <a href="new-vbrcloudfailoverplanobject.md"><code>New-VBRCloudFailoverPlanObject</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrcloudfailoverplanobject.md"><code>VBRCloudFailoverPlanObject[]</code></a></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">Description</span></p>
        </td>
        <td>
          <p>Specifies the description of the failover plan.</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">EnablePublicIpRule</span></p>
        </td>
        <td>
          <p>Enables the failover plan to use the public IP rules configured in the <a href="vbrfailoverplanobject.md"><code>VBRFailoverPlanObject</code></a> or <a href="vbrcloudfailoverplanobject.md"><code>VBRCloudFailoverPlanObject</code></a> objects.</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">FailoverPlanObject</span></p>
        </td>
        <td>
          <p>Specifies the array of VMs you want to add to the failover plan.</p><p>Accepts the <a href="vbrfailoverplanobject.md"><code>VBRFailoverPlanObject[]</code></a> object. To get this object, run the <a href="new-vbrfailoverplanobject.md"><code>New-VBRFailoverPlanObject</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrfailoverplanobject.md"><code>VBRFailoverPlanObject[]</code></a></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">Name</span></p>
        </td>
        <td>
          <p>Specifies the name that you want to assign to the failover plan.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">PostfailoverCommand</span></p>
        </td>
        <td>
          <p>Specifies the path to the script you want to automatically run after failing over to replicas is complete.</p><p>Veeam Backup & Replication provides a 10- minute timeout for the script.</p><p>In case the script does not run successfully or timeout ends, the failover proceeds disregarding script failure.</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">PrefailoverCommand</span></p>
        </td>
        <td>
          <p>Specifies the path to the script you want to automatically run before failing over to replicas.</p><p>Veeam Backup & Replication provides a 10-minute timeout for the script.</p><p>In case the script does not run successfully or timeout ends, the failover is not performed.</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>
    </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
- [`VBRFailoverPlan`](vbrfailoverplan.md)
- [`VBRCloudFailoverPlan`](vbrcloudfailoverplan.md)

## Examples

::: example
### Example 1. Creating Failover Plan for Group of VMs

This example shows how to create a failover plan for a group of VMs: a DNS server and two Microsoft Exchange servers.

```
$DNS = Find-VBRViEntity -Name "DNSServer" | New-VBRFailoverPlanObject -BootDelay 0
$MSExchange01 = Find-VBRViEntity -Name "MS_Exchange_Server_01" | New-VBRFailoverPlanObject -BootOrder 1  -BootDelay 180
$MSExchange02 = Find-VBRViEntity -Name "MS_Exchange_Server_02" | New-VBRFailoverPlanObject -BootOrder 2  -BootDelay 120
Add-VBRFailoverPlan -Name "MS Exchange Group Failover" -FailoverPlanObject $DNS, $MSexchange01, $MSExchange02 -Description "Failover plan for the mail servers group"
```

Perform the following steps:

1. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Pipe the cmdlet output to the `New-VBRFailoverPlanObject` cmdlet. Specify the `BootDelay` parameter value. Save the result to the `$DNS` variable.
2. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Pipe the cmdlet output to the `New-VBRFailoverPlanObject` cmdlet. Specify the `BootOrder` and `BootDelay` parameter values. Save the result to the `$MSExchange01` variable.
3. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Pipe the cmdlet output to the `New-VBRFailoverPlanObject` cmdlet. Specify the `BootOrder` and `BootDelay` parameter values. Save the result to the `$MSExchange02` variable.
4. Run the `Add-VBRFailoverPlan` cmdlet. Specify the `Name` parameter value. Set the `$DNS`, `$MSexchange01`, `$MSExchange02` variables as the `FailoverPlanObject` parameter value. Specify the `Description` parameter value.

:::

::: example
### Example 2. Creating Cloud Failover Plan

[Cloud] This example shows how to create a cloud failover plan named `Cloud Failover` for a replica.

```
$point = Get-VBRRestorePoint -Name "Cloud VM 01" | Sort-Object $_.creationtime -Descending | Select -First 1
$cloudreplica = New-VBRCloudFailoverPlanObject -RestorePoint $point -BootDelay 0
Add-VBRFailoverPlan -Name "Cloud Group Failover" -CloudFailoverPlanObject $cloudreplica -Description "Cloud replica failover plan"
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Specify the `Name` parameter value. Use the `Sort-Object` and the `Select` commands to select the first restore point. Save the result to the `$point` variable.
2. Run the [`New-VBRCloudFailoverPlanObject`](new-vbrcloudfailoverplanobject.md) cmdlet. Set the `$point` variable as the `RestorePoint` parameter value. Specify the `BootDelay` parameter value. Save the result to the `$cloudreplica` variable.
3. Run the `Add-VBRFailoverPlan` cmdlet. Specify the `Name` parameter value. Set the `$cloudreplica` variable as the `CloudFailoverPlanObject` parameter value. Specify the `Description` parameter value.

:::

## Related Commands

- [`New-VBRFailoverPlanObject`](new-vbrfailoverplanobject.md)
- [`New-VBRCloudFailoverPlanObject`](new-vbrcloudfailoverplanobject.md)