New-VBRApplicationGroupStartupOptions

In this article

    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 the About CommonParameters section of 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