---
title: "New-VBRFailoverPlanObject"
description: "Creates the VBRFailoverPlanObject object. Platform: VMware, Hyper-V Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: RestorePoint Vm This cmdlet creates the VBRFailoverPlanObject"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrfailoverplanobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Replication > Failover Plans > New-VBRFailoverPlanObject"
dateModified: "2026-08-20"
---

# New-VBRFailoverPlanObject

## Short Description
Creates the [`VBRFailoverPlanObject`](vbrfailoverplanobject.md) object.

**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>RestorePoint</code></p>

```
New-VBRFailoverPlanObject -RestorePoint <COib> [-BootOrder <Int32>] [-BootDelay <Int32>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Vm</code></p>

```
New-VBRFailoverPlanObject -Vm <IItem> [-BootOrder <Int32>] [-BootDelay <Int32>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates the [`VBRFailoverPlanObject`](vbrfailoverplanobject.md) object. This object contains the VM that you want to add to a failover plan. It is used then in the [`Add-VBRFailoverPlan`](add-vbrfailoverplan.md) cmdlet.

You must create the [`VBRFailoverPlanObject`](vbrfailoverplanobject.md) object for each VM that you want to add to the failover plan. For each VM, you can set the boot order and the delay time.

- The boot order indicates the order in which the VMs will start by the failover plan. Make sure you set the dependent VMs to start after the VMs they depend on.
- The delay time is an interval between each VM start. Use delay intervals to make sure that some VMs are already running at the moment the dependent VMs start.

## 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 VM 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 VMs, these VMs 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 VM 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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies the restore point of the replica that you want to add to the cloud failover plan.</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">Vm</span></p>
        </td>
        <td>
          <p>Specifies the VM you want to add to the failover plan.</p><p>Accepts the <code>IItem</code> object. To get this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>IItem</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
[`VBRFailoverPlanObject`](vbrfailoverplanobject.md)

## Examples

::: example
### Example 1. Create VBRFailoverPlanObject Object for Group of Servers

This example shows how to create three [`VBRFailoverPlanObject`](vbrfailoverplanobject.md) objects for the group of mail servers: a DNS server and two Microsoft Exchange servers. The DNS server starts first followed by the two Microsoft Exchange servers started with a delay.

```
$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
```

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 to be used with other cmdlets.
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 to be used with other cmdlets.
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 to be used with other cmdlets.

:::

::: example
### Example 2. Create VBRFailoverPlanObject Object for Server

This example shows how to create the [`VBRFailoverPlanObject`](vbrfailoverplanobject.md) objects for the `MS_Exchange_Server_01` server.

```
$vm1 = Find-VBRViEntity -Name "MS_Exchange_Server_01"
$MSExchange01 = New-VBRFailoverPlanObject -Vm $vm1 -BootOrder 1 -BootDelay 180
```

Perform the following steps:

1. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$vm1` variable.
2. Run the `New-VBRFailoverPlanObject` cmdlet. Specify the following settings:

   - Set the `$vm1` variable as the `Vm` parameter value.
   - Specify the `BootOrder` parameter value.
   - Specify the `BootDelay` parameter value.
   - Save the result to the `$MSExchange01` variable to be used with other cmdlets.

:::

## Related Commands

[`Find-VBRViEntity`](find-vbrvientity.md)