Start-VBRViReplicaFailover

Short Description

Fails over corrupted VMware VMs to their replicas.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

  • Perform failover.

Start-VBRViReplicaFailover -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-PowerOn] [-ReIp] [-WhatIf] [-Confirm]   [<CommonParameters>]

  • Perform permanent failover.

Start-VBRViReplicaFailover -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Definite] [-WhatIf] [-Confirm]  [<CommonParameters>]

  • Perform planned failover.

Start-VBRViReplicaFailover -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Planned] [-WhatIf] [-Confirm]  [<CommonParameters>]

Detailed Description

This cmdlet fails over a corrupted VMware VM to its successfully created replica.

Run the Start-VBRViReplicaFailback cmdlet to fail back to the original VM.

Run the Stop-VBRReplicaFailover cmdlet to undo failover.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

RestorePoint

Specifies the replica restore point to which you want to fail over.

Accepts the COib object. To get this object, run the Get-VBRRestorePoint cmdlet.

True

1

True (ByValue,
ByProperty
Name)

Reason

Specifies the reason for performing a failover.

String

False

Named

False

RunAsync

Defines that the command returns immediately without waiting for the task to complete.

SwitchParameter

False

Named

False

PowerOn

Defines that the cmdlet will power on replica VM after the failover. Otherwise, you will need to power on the replica VM manually.

SwitchParameter

False

Named

False

ReIp

Defines that the replica will use the re-IP rules that are set in the replication job.

Note: Do not enable the re-IP if the re-IP rules are not configured in the replication job.

SwitchParameter

False

Named

False

Definite

Defines that the failover is permanent.

SwitchParameter

False

Named

False

Planned

Defines that the failover is planned.

Default: The planned failover option is enabled.

SwitchParameter

False

Named

False

WhatIf

Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.

SwitchParameter

False

Named

False

Confirm

Defines that the cmdlet will display a prompt that asks if you want to continue running the command.

SwitchParameter

False

Named

False

<CommonParameters>

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

Output Object

None.

Examples

Start-VBRViReplicaFailoverExample 1. Performing Failover to VM Replica

Start-VBRViReplicaFailoverExample 2. Performing Failover to Latest Restore Point [Using Pipeline]

Start-VBRViReplicaFailoverExample 3. Performing Planned Failover to VM Replica

Start-VBRViReplicaFailoverExample 4. Performing Permanent Failover

Related Commands

Page updated 6/27/2024

Page content applies to build 12.3.1.1139