Set-VBRApplicationGroupStartupOptions
Short Description
Modifies VM startup settings for staged restore.
Applies to
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Syntax
Set-VBRApplicationGroupStartupOptions -Options <VBRApplicationGroupStartupOptions> [-MaximumBootTime <int>] [-ApplicationInitializationTimeout <int>] [-MemoryAllocationPercent <int>] [-HeartbeatCheck] [-PingCheck] [<CommonParameters>] |
Detailed Description
The cmdlet modifies startup settings for staged restore.
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
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|---|---|---|---|---|
Options | Specifies the VM startup settings that you want to modify. | Accepts the VBRApplicationGroupStartupOptions object. To get this object, run the New-VBRApplicationGroupStartupOptions cmdlet. | True | Named | False |
MaximumBootTime | Specifies the period that is required for VMs to boot. Default: 600 sec. | Int | False | Named | False |
ApplicationInitializationTimeout | Specifies a timeout required to initialize applications on VMs. Default: 120 sec. | Int | False | Named | False |
MemoryAllocationPercent | Specifies the amount of memory that you want to pre-allocate to VMs when these VMs start. Default: 100 percent. | Int | False | Named | False |
HeartbeatCheck | Defines that Veeam Backup & Replication will perform a heartbeat test for verified VMs. | SwitchParameter | False | Named | False |
PingCheck | Defines that Veeam Backup & Replication will perform a ping test for verified VMs. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.
Output Object
The cmdlet returns the VBRApplicationGroupStartupOptions object that contains VM startup settings for staged restore.
Examples
Modifying Startup Settings for VMs in Application Group
This example shows how to modify startup settings for VMs added to an application group. Veeam Backup & Replication will perform staged restore with the following settings:
- The stabilization period is set to 200 sec.
- The period to initialize the guest applications is set to 150.
- The amount of memory provided for the VM is set to 80 percent.
$startup = New-VBRApplicationGroupStartupOptions -MaximumBootTime 200 -ApplicationInitializationTimeout 150 -MemoryAllocationPercent 80 $newoptions = Set-VBRApplicationGroupStartupOptions -Options $startup -MaximumBootTime 250 -ApplicationInitializationTimeout 80 -MemoryAllocationPercent 67 |
Perform the following steps:
- Run the New-VBRApplicationGroupStartupOptions cmdlet. Specify the MaximumBootTime, ApplicationInitializationTimeout and MemoryAllocationPercent parameter value. Save the result to the $startup variable.
- Run the Set-VBRApplicationGroupStartupOptions cmdlet. Specify the following settings:
- Set the $startup variable as the Options parameter value.
- Specify the MaximumBootTime parameter value.
- Specify the ApplicationInitializationTimeout parameter value.
- Specify the MemoryAllocationPercent parameter value.
Related Commands