Add-VBRFailoverPlan

Short Description

Creates failover plans or cloud failover plans.

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

FailoverPlanObject

Add-VBRFailoverPlan -Name <String> [-Description <String>] -FailoverPlanObject <VBRFailoverPlanObject[]>

[-PrefailoverCommand <String>] [-PostfailoverCommand <String>] [-EnablePublicIpRule] [<CommonParameters>]

CloudFailoverPlanObject

Add-VBRFailoverPlan -Name <String> [-Description <String>]

-CloudFailoverPlanObject <VBRCloudFailoverPlanObject[]> [-PrefailoverCommand <String>]

[-PostfailoverCommand <String>] [-EnablePublicIpRule] [<CommonParameters>]

Detailed Description

This cmdlet creates the following types of failover plans:

Failover plan
Cloud failover plan

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
CloudFailoverPlanObject	Specifies the array of VMs replicated to cloud. These VMs will be added to the cloud failover plan. Accepts the `VBRCloudFailoverPlanObject[]` object. To get this object, run the `New-VBRCloudFailoverPlanObject` cmdlet.	`VBRCloudFailoverPlanObject[]`	True	Named	False
Description	Specifies the description of the failover plan.	`String`	False	Named	False
EnablePublicIpRule	Enables the failover plan to use the public IP rules configured in the `VBRFailoverPlanObject` or `VBRCloudFailoverPlanObject` objects.	`SwitchParameter`	False	Named	False
FailoverPlanObject	Specifies the array of VMs you want to add to the failover plan. Accepts the `VBRFailoverPlanObject[]` object. To get this object, run the `New-VBRFailoverPlanObject` cmdlet.	`VBRFailoverPlanObject[]`	True	Named	False
Name	Specifies the name that you want to assign to the failover plan.	`String`	True	Named	False
PostfailoverCommand	Specifies the path to the script you want to automatically run after failing over to replicas is complete. Veeam Backup & Replication provides a 10- minute timeout for the script. In case the script does not run successfully or timeout ends, the failover proceeds disregarding script failure.	`String`	False	Named	False
PrefailoverCommand	Specifies the path to the script you want to automatically run before failing over to replicas. Veeam Backup & Replication provides a 10-minute timeout for the script. In case the script does not run successfully or timeout ends, the failover is not performed.	`String`	False	Named	False

<CommonParameters>

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

Output Object

Examples

Add-VBRFailoverPlan Example 1. Creating Failover Plan for Group of VMs

This example shows how to create a failover plan for a group of VMs: a DNS server and two Microsoft Exchange servers.

$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

Add-VBRFailoverPlan -Name "MS Exchange Group Failover" -FailoverPlanObject $DNS, $MSexchange01, $MSExchange02 -Description "Failover plan for the mail servers group"

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.
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.
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.
Run the Add-VBRFailoverPlan cmdlet. Specify the Name parameter value. Set the $DNS, $MSexchange01, $MSExchange02 variables as the FailoverPlanObject parameter value. Specify the Description parameter value.

Add-VBRFailoverPlan Example 2. Creating Cloud Failover Plan

[Cloud] This example shows how to create a cloud failover plan named Cloud Failover for a replica.

$point = Get-VBRRestorePoint -Name "Cloud VM 01" | Sort-Object $_.creationtime -Descending | Select -First 1

$cloudreplica = New-VBRCloudFailoverPlanObject -RestorePoint $point -BootDelay 0

Add-VBRFailoverPlan -Name "Cloud Group Failover" -CloudFailoverPlanObject $cloudreplica -Description "Cloud replica failover plan"

Perform the following steps:

Run the Get-VBRRestorePoint cmdlet. Specify the Name parameter value. Use the Sort-Object and the Select commands to select the first restore point. Save the result to the $point variable.
Run the New-VBRCloudFailoverPlanObject cmdlet. Set the $point variable as the RestorePoint parameter value. Specify the BootDelay parameter value. Save the result to the $cloudreplica variable.
Run the Add-VBRFailoverPlan cmdlet. Specify the Name parameter value. Set the $cloudreplica variable as the CloudFailoverPlanObject parameter value. Specify the Description parameter value.