---
title: "Set-VBRFailoverPlanObject"
description: "This cmdlet modifies VMs added to a failover plan. Run the Set-VBRCloudFailoverPlanObject cmdlet to modify VMs in cloud failover plans. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrfailoverplanobject.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Replication > Failover Plans > Set-VBRFailoverPlanObject"
dateModified: "2026-08-19"
---

# Set-VBRFailoverPlanObject

## Short Description
Modifies VMs in failover plans.

**Platform**: VMware, Hyper-V

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

## Syntax
```
Set-VBRFailoverPlanObject -Object <VBRFailoverPlanObject> [-BootOrder <Int32>] [-BootDelay <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies VMs added to a failover plan.

Run the [`Set-VBRCloudFailoverPlanObject`](set-vbrcloudfailoverplanobject.md) cmdlet to modify VMs in cloud failover plans.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## 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 new value for the delay time for the VM.</p><p>The delay time is set in seconds.</p><p>Default: <code>60</code> sec.</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 new value for 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">Object</span></p>
        </td>
        <td>
          <p>Specifies the VM you want modify.</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>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. Setting New Boot Delay Value [Using Pipeline]

This example shows how to set a new boot delay value for the server that was earlier assigned to the `$MSExchange01` variable.

```
$MSExchange01 = Find-VBRViEntity -Name "MSExchange01" | New-VBRFailoverPlanObject -BootDelay 0
$MSExchange01 | Set-VBRFailoverPlanObject -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`](new-vbrfailoverplanobject.md) cmdlet. Specify the `BootDelay` parameter value. Save the result to the `$MSExchange01` variable to be used with other cmdlets.
2. Pipe the `$MSExchange01` variable output to the `Set-VBRFailoverPlanObject` cmdlet. Specify the `BootDelay` parameter values.

:::

::: example
### Example 2. Setting New Boot Delay Value [Using Variable]

This example shows how to set a new boot delay value for the server that was earlier assigned to the `$MSExchange01` variable.

```
$MSExchange01 = Find-VBRViEntity -Name "MSExchange01" | New-VBRFailoverPlanObject -BootDelay 0
$MSExchange01 = Set-VBRFailoverPlanObject -Object $MSExchange01 -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`](new-vbrfailoverplanobject.md) cmdlet. Specify the `BootDelay` parameter value. Save the result to the `$MSExchange01` variable to be used with other cmdlets.
2. Run the `Set-VBRFailoverPlanObject` cmdlet. Set the `$MSExchange01` variable as the `Object` parameter value. Specify the `BootDelay` parameter values. Save the result to the `$MSExchange01` variable to be used with other cmdlets.

:::