New-VBRFailoverPlanObject

Short Description

Creates the VBRFailoverPlanObject object.

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

RestorePoint

New-VBRFailoverPlanObject -RestorePoint <COib> [-BootOrder <Int32>] [-BootDelay <Int32>] [<CommonParameters>]
Vm

New-VBRFailoverPlanObject -Vm <IItem> [-BootOrder <Int32>] [-BootDelay <Int32>] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRFailoverPlanObject object. This object contains the VM that you want to add to a failover plan. It is used then in the Add-VBRFailoverPlan cmdlet.

You must create the VBRFailoverPlanObject object for each VM that you want to add to the failover plan. For each VM, you can set the boot order and the delay time.

The boot order indicates the order in which the VMs will start by the failover plan. Make sure you set the dependent VMs to start after the VMs they depend on.
The delay time is an interval between each VM start. Use delay intervals to make sure that some VMs are already running at the moment the dependent VMs start.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
BootDelay	Specifies the delay time for the VM to boot. The delay time is set in seconds. If omitted, the delay time will be set to 60 sec by default. If you set boot delay to `0` to a number of VMs, these VMs will start simultaneously.	`Int32`	False	Named	False
BootOrder	Specifies the order number by which the VM will boot.	`Int32`	False	Named	False
RestorePoint	Specifies the restore point of the replica that you want to add to the cloud failover plan. Accepts the `COib` object. To get this object, run the `Get-VBRRestorePoint` cmdlet.	`COib`	True	Named	True (ByPropertyName, ByValue)
Vm	Specifies the VM you want to add to the failover plan. Accepts the `IItem` object. To get this object, run the `Find-VBRViEntity` cmdlet.	`IItem`	True	Named	True (ByPropertyName, ByValue)

<CommonParameters>

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

Output Object

VBRFailoverPlanObject

Examples

New-VBRFailoverPlanObject Example 1. Create VBRFailoverPlanObject Object for Group of Servers

This example shows how to create three VBRFailoverPlanObject objects for the group of mail servers: a DNS server and two Microsoft Exchange servers. The DNS server starts first followed by the two Microsoft Exchange servers started with a delay.

$DNS = Find-VBRViEntity -Name "DNSServer" | New-VBRFailoverPlanObject -BootDelay 0

$MSExchange01 = Find-VBRViEntity -Name "MS_Exchange_Server_01" | New-VBRFailoverPlanObject -BootOrder 1 -BootDelay 180

$MSExchange02 = Find-VBRViEntity -Name "MS_Exchange_Server_02" | New-VBRFailoverPlanObject -BootOrder 2 -BootDelay 120

Perform the following steps:

Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Pipe the cmdlet output to the New-VBRFailoverPlanObject cmdlet. Specify the BootDelay parameter value. Save the result to the $DNS variable to be used with other cmdlets.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Pipe the cmdlet output to the New-VBRFailoverPlanObject cmdlet. Specify the BootOrder and BootDelay parameter values. Save the result to the $MSExchange01 variable to be used with other cmdlets.
Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Pipe the cmdlet output to the New-VBRFailoverPlanObject cmdlet. Specify the BootOrder and BootDelay parameter values. Save the result to the $MSExchange02 variable to be used with other cmdlets.

New-VBRFailoverPlanObject Example 2. Create VBRFailoverPlanObject Object for Server

This example shows how to create the VBRFailoverPlanObject objects for the MS_Exchange_Server_01 server.

$vm1 = Find-VBRViEntity -Name "MS_Exchange_Server_01"

$MSExchange01 = New-VBRFailoverPlanObject -Vm $vm1 -BootOrder 1 -BootDelay 180

Perform the following steps:

Run the Find-VBRViEntity cmdlet. Specify the Name parameter value. Save the result to the $vm1 variable.
Run the New-VBRFailoverPlanObject cmdlet. Specify the following settings:
- Set the $vm1 variable as the Vm parameter value.
- Specify the BootOrder parameter value.
- Specify the BootDelay parameter value.
- Save the result to the $MSExchange01 variable to be used with other cmdlets.

Find-VBRViEntity