Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

Start-VBRHvReplicaFailover

Short Description

Fails over corrupted Hyper-V VMs to their replicas.

Applies to

Platform: Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides 3 parameter sets.

  • For failover:

Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync]  [<CommonParameters>]

  • For permanent failover:

Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync] [-Definite]  [<CommonParameters>]

  • For planned failover:

Start-VBRHvReplicaFailover [-RestorePoint] <COib> [-Reason <string>] [-RunAsync] [-Planned]  [<CommonParameters>]

Detailed Description

This cmdlet fails over a corrupted Hyper-V VM to its successfully created replica.

This cmdlet provides 3 parameter sets for the following operations:

  • Failover
  • Permanent failover
  • Planned failover

Run Start-VBRHvReplicaFailback to fail back to the original VM.

Run Stop-VBRReplicaFailover to undo failover. You can also undo planned failover.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Restore
Point

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

True

1

True (ByValue,
ByProperty
Name)

False

Reason

Specifies the reason for performing a failover.

False

Named

False

False

RunAsync

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

False

Named

False

False

Definite

Indicates that the failover is permanent.

False

Named

False

False

Planned

Indicates that the failover is planned.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

Related Commands

Get-VBRRestorePoint

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Endpoint Backup Documentation

Veeam Management Pack Documentation