New-VBRApplicationGroupStartupOptions

Short Description

Creates VM startup settings for staged restore.

Applies to

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 cmdlet to restore VMware VMs with the staged restore option.

Run the Start-VBRHvRestoreVM cmdlet to restore Hyper-V VMs with the staged restore option.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

MaximumBootTime

Specifies the period that is required for VMs to boot.

Default: 600 sec.

True

Named

False

ApplicationInitializationTimeout

Specifies a timeout required to initialize applications on VMs.

Default: 120 sec.

True

Named

False

MemoryAllocationPercent

Specifies the amount of memory that you want to pre-allocate to VMs when these VMs start.

Default: 100 percent.

True

Named

False

HeartbeatCheck

Defines that Veeam Backup & Replication will perform a heartbeat test for verified VMs.

False

Named

False

PingCheck

Defines that Veeam Backup & Replication will perform a ping test for verified VMs.

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Return Type

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

Examples

New-VBRApplicationGroupStartupOptionsExample 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

New-VBRApplicationGroupStartupOptionsExample 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