---
title: "New-VBRCloudFailoverPlanObject"
description: "Defines VM replicas that you want to add to a failover plan. Platform: VMware, Hyper-V Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates a new VBRCloudFailoverPlanObject object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcloudfailoverplanobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Failover Plans > New-VBRCloudFailoverPlanObject"
dateModified: "2026-08-20"
---

# New-VBRCloudFailoverPlanObject

## Short Description
Defines VM replicas that you want to add to a failover plan.

**Platform**: VMware, Hyper-V

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

## Syntax
```
New-VBRCloudFailoverPlanObject -RestorePoint <COib> [-BootOrder <Int32>] [-BootDelay <Int32>]
 [-PublicIpRule <VBRFailoverPlanPublicIPRule[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates a new [`VBRCloudFailoverPlanObject`](vbrcloudfailoverplanobject.md) object. This object contains VM replicas that you want to add to a cloud failover plan. You can add the following types of replicas for a failover plan:

- Simple cloud replicas
- Cloud Director cloud replicas

Run the [`Add-VBRFailoverPlan`](add-vbrfailoverplan.md) cmdlet to create a failover plan.

::: note

You must create the [`VBRCloudFailoverPlanObject`](vbrcloudfailoverplanobject.md) object for each replica that you want to add to the 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">BootDelay</span></p>
        </td>
        <td>
          <p>Specifies the delay time for the replica to boot.</p><p>The delay time is set in seconds.</p><p>If omitted, the delay time will be set to 60 sec by default.</p><p>If you set boot delay to <code>0</code> to a number of replicas, these replicas will start simultaneously.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">BootOrder</span></p>
        </td>
        <td>
          <p>Specifies the order number by which the replica will boot.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</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">PublicIpRule</span></p>
        </td>
        <td>
          <p>Specifies the array of rules for mapping public IP and ports to the IP and ports of the replica VM.</p><p>Accepts the <a href="vbrfailoverplanpubliciprule.md"><code>VBRFailoverPlanPublicIPRule[]</code></a> object. To create this object, run the <a href="new-vbrfailoverplanpubliciprule.md"><code>New-VBRFailoverPlanPublicIPRule</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrfailoverplanpubliciprule.md"><code>VBRFailoverPlanPublicIPRule[]</code></a></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 restore point of the cloud replica that you want to add to the cloud failover plan.</p><p>Accepts the <code>COib</code> object. To create 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>
    </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
[`VBRCloudFailoverPlanObject`](vbrcloudfailoverplanobject.md)

## Examples

::: example
### Adding VM Replicas to Cloud Failover Plan

This example shows how to create [`VBRCloudFailoverPlanObject`](vbrcloudfailoverplanobject.md) objects for three servers: a DNS server and two Microsoft Exchange servers. The servers will boot with the following order:

- The DNS server boots first.
- The first Microsoft Exchange server boots with the `180` seconds delay.
- The second Microsoft Exchange server boots with the `120` seconds delay.

```
$DNS = Get-VBRRestorePoint -Name "DNSServer" | Sort-Object $_.creationtime -Descending | Select -First 1
$MSExchange01 = Get-VBRRestorePoint -Name "MS_Exchange_Server_01" | Sort-Object $_.creationtime -Descending | Select -First 1
$MSExchange02 = Get-VBRRestorePoint -Name "MS_Exchange_Server_02" | Sort-Object $_.creationtime -Descending | Select -First 1
New-VBRCloudFailoverPlanObject -RestorePoint $DNS -BootDelay 0
New-VBRCloudFailoverPlanObject -RestorePoint $MSExchange01 -BootOrder 1  -BootDelay 180
New-VBRCloudFailoverPlanObject -RestorePoint $MSExchange02 -BootOrder 2  -BootDelay 120
```

Perform the following steps:

1. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Use the `Sort-Object` and the `Select` commands to select the first restore point. Save the result to the `$DNS` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Use the `Sort-Object` and the `Select` commands to select the first restore point. Save the result to the `$MSExchange01` variable.
3. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Use the `Sort-Object` and the `Select` commands to select the first restore point. Save the result to the `$MSExchange02` variable.
4. Run the `New-VBRCloudFailoverPlanObject` cmdlet. Set the `$DNS` variable as the `RestorePoint` parameter value. Set `0` as the `BootDelay` parameter value.
5. Run the `New-VBRCloudFailoverPlanObject` cmdlet. Set the `$MSExchange01` variable as the `RestorePoint` parameter value. Set `1` as the `BootOrder` parameter value and `180` as the `BootDelay` parameter value.
6. Run the `New-VBRCloudFailoverPlanObject` cmdlet. Set the `$MSExchange02` variable as the `RestorePoint` parameter value. Set `2` as the `BootOrder` parameter value and `120` as the `BootDelay` parameter value.

:::

## Related Commands

- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Find-VBRViEntity`](find-vbrvientity.md)