---
title: "New-VBRApplicationGroupStartupOptions"
description: "Creates VM startup settings for staged restore. Product Edition: Enterprise, Enterprise Plus, Veeam Universal License The cmdlet creates the VBRApplicationGroupStartupOptions object that contains VM startup settings for staged restore."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrapplicationgroupstartupoptions_surebackup.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Application Groups > New-VBRApplicationGroupStartupOptions"
dateModified: "2026-08-19"
---

# New-VBRApplicationGroupStartupOptions

## Short Description

Creates VM startup settings for staged restore.

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

## Syntax

```
New-VBRApplicationGroupStartupOptions -MaximumBootTime <int> -ApplicationInitializationTimeout <int> -MemoryAllocationPercent <int> [-HeartbeatCheck] [-PingCheck]  [<CommonParameters>]
```

## Detailed Description

The cmdlet creates the `VBRApplicationGroupStartupOptions` object that contains VM startup settings for staged restore.

Run the [`Start-VBRRestoreVM`](start-vbrrestorevm.md) cmdlet to restore VMware VMs with the staged restore option.

Run the [`Start-VBRHvRestoreVM`](start-vbrhvrestorevm.md) cmdlet to restore Hyper-V VMs with the staged restore option.

## Parameters

<table style="width:100%;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th>
      <p>Parameter</p>
    </th>
    <th>
      <p>Description</p>
    </th>
    <th>
      <p>Type</p>
    </th>
    <th>
      <p>Required</p>
    </th>
    <th>
      <p>Position</p>
    </th>
    <th>
      <p>Accept<br/>Pipeline<br/>Input</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td>
      <p class="Table_Text_Bold"><span class="Table_Text_Bold">MaximumBootTime</span></p>
    </td>
    <td>
      <p>Specifies the period that is required for VMs to boot.</p>
      <p>Default: 600 sec.</p>
    </td>
    <td>
      <p>Int</p>
    </td>
    <td>
      <p>True</p>
    </td>
    <td>
      <p>Named</p>
    </td>
    <td>
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td>
      <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationInitializationTimeout</span></p>
    </td>
    <td>
      <p>Specifies a timeout required to initialize applications on VMs.</p>
      <p>Default: 120 sec.</p>
    </td>
    <td>
      <p>Int</p>
    </td>
    <td>
      <p>True</p>
    </td>
    <td>
      <p>Named</p>
    </td>
    <td>
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td>
      <p class="Table_Text_Bold"><span class="Table_Text_Bold">MemoryAllocationPercent</span></p>
    </td>
    <td>
      <p>Specifies the amount of memory that you want to pre-allocate to VMs when these VMs start.</p>
      <p>Default: 100 percent.</p>
    </td>
    <td>
      <p>Int</p>
    </td>
    <td>
      <p>True</p>
    </td>
    <td>
      <p>Named</p>
    </td>
    <td>
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td>
      <p class="Table_Text_Bold"><span class="Table_Text_Bold">HeartbeatCheck</span></p>
    </td>
    <td>
      <p>Defines that Veeam Backup & Replication will perform a heartbeat test for verified VMs.</p>
    </td>
    <td>
      <p>SwitchParameter</p>
    </td>
    <td>
      <p>False</p>
    </td>
    <td>
      <p>Named</p>
    </td>
    <td>
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td>
      <p class="Table_Text_Bold"><span class="Table_Text_Bold">PingCheck</span></p>
    </td>
    <td>
      <p>Defines that Veeam Backup & Replication will perform a ping test for verified VMs.</p>
    </td>
    <td>
      <p>SwitchParameter</p>
    </td>
    <td>
      <p>False</p>
    </td>
    <td>
      <p>Named</p>
    </td>
    <td>
      <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

The cmdlet returns the `VBRApplicationGroupStartupOptions` object that contains VM startup settings for staged restore.

## Examples

::: dropdown
### Example 1. Defining Startup Settings

This command defines startup settings for VMs added to an application group. Veeam Backup & Replication will perform staged restore with the following VM startup settings:

- The period that is required for VMs to boot is set to 200 sec.
- The timeout required to initialize applications on VMs is set to 150.
- The amount of memory provided for VMs is set to 80 percent.

```
$startupoptions = New-VBRApplicationGroupStartupOptions -MaximumBootTime 200 -ApplicationInitializationTimeout 150 -MemoryAllocationPercent 80
```

:::

::: dropdown
### Example 2. Defining Startup Settings with Heartbeat and Ping Tests

This command defines startup settings for VMs added to an application group. Veeam Backup & Replication will perform staged restore with the following VM startup settings:

- The period that is required for VMs to boot is set to 150 sec.
- The timeout required to initialize applications on VMs is set to 130.
- The amount of memory provided for VMs is set to 110 percent.

```
$startupoptions = New-VBRApplicationGroupStartupOptions -MaximumBootTime 150 -ApplicationInitializationTimeout 130 -MemoryAllocationPercent 110 -HeartbeatCheck -PingCheck
```

:::