Start-VBRFailoverPlan

Short Description

Starts failover by failover plan.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

  • Start failover by failover plan.

Start-VBRFailoverPlan -FailoverPlan <VBRFailoverPlan[]> [-Wait] [-Force] [<CommonParameters>]

  • Start failover to a specific restore point.

Start-VBRFailoverPlan -FailoverPlan <VBRFailoverPlan[]> [-FromDate <datetime>] [-Wait] [-Force] [<CommonParameters>]

  • Start failover in test mode.

Start-VBRFailoverPlan -FailoverPlan <VBRFailoverPlan[]> [-Wait] [-Force] [-KeepAliveDuration <Int32>] [-Test]  [<CommonParameters>]

Detailed Description

This cmdlet starts failover by failover plan. With this cmdlet, you can start a number of failover processes.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

FailoverPlan

Specifies the array of failover plans you want to start.

Accepts the VBRFailoverPlan or VBRCloudFailoverPlan objects. To get these objects, run the Get-VBRFailoverPlan cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

FromDate

Use this parameter to fail over to a particular restore point.

Specifies the date and time to which you want to fail over. Veeam Backup & Replication will find a restore point closest to this moment.

If omitted, Veeam Backup & Replication will fail over to the latest restore point.

DateTime

False

Named

False

Wait

Use this parameter to manage starting multiple failover processes.

If you provide this parameter, the next failover process will wait for the previous to end.

SwitchParameter

False

Named

False

Force

Used for cloud failovers to start full failover after the user's site is already partially failed over to cloud replicas.

If you provide this parameter, the cmdlet turns off the user appliance without notifying the user. Otherwise, the cmdlet will display a warning.

SwitchParameter

False

Named

False

KeepAliveDuration

Specifies a timeout in minutes for a CDP replicas failover test. The CDP replica will be active during this period of time.

Note: Consider the following:

  • You must use the Test parameter.  
  • To stop the failover testing beforehand, run the Undo-VBRFailoverPlan.

Int32

False

Named

False

Test

Defines that the failover runs in test mode.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

VBRBackupSession[]

Examples

Start-VBRFailoverPlanExample 1. Starting Failover Plan [Using Pipeline]

Start-VBRFailoverPlanExample 2. Starting Failover Plan [Using Variable]

Start-VBRFailoverPlanExample 3. Starting Failover Plans for Specific Restore Point

Related Commands

Page updated 12/23/2024

Page content applies to build 12.3.1.1139