This is an archive version of the document. To get the most up-to-date information, see the current version.

Stop-VBRViReplicaFailback

In this article

    Short Description

    Undoes replica failback.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus

    Syntax

    PS C:\PS> Start-VBRViReplicaFailback -RestorePoint <COib> [-Reason <string>] [-RunAsync] [-Complete] [-PowerOn] [-StoragePolicyAction <VBRStoragePolicyAction> {Current | Stored | Default}] [-WhatIf] [-Confirm] [<CommonParameters>]

    Related Commands

    Get-VBRRestorePoint

    Detailed Description

    This cmdlet allows you to undo the replica failback started with Start-VBRViReplicaFailback or Start-VBRHvReplicaFailback.

    If you tried to fail back to the production VM but was unable to, because i.e. it was non-functional or corrupted, you can undo the failback and return to the working replica.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    RestorePoint

    Specifies the restore point of the replica VM for which you want to undo the failback.

    True

    1

    True (ByValue,
    ByProperty
    Name)

    False

    RunAsync

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

    False

    Named

    False

    False

    WhatIf

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

    False

    Named

    False

    False

    Confirm

    Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.

    False

    Named

    False

    False

    Storage
    Policy
    Action

    Specifies the strategy for selecting storage policy profile in case the storage profile of the backed up VM differs from the profile of the original VM.

    Current: the restored VM will be subscribed to the same profile as in backup (if such profile still exists) or to the profile to which the original VM is subscribed (if profile as in backup was removed).

    Default: the restored VM will be subscribed to the profile that is set as default for the target datastore.

    Stored: the restored VM will be subscribed to the profile as in backup (if such profile still exists).

    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.

    Example 1

    This command stops failback from the replica VM named "WebServer_replica". The restore point is obtained with Get-VBRRestorePoint and piped down. The restore points of the VM are filtered with Sort-Object method by the "creationtime" property to get the most recent one. The RunAsync parameter is set to bring the process to the background.

    PS C:\PS> Get-VBRRestorePoint -Name "WebServer_replica" | Sort-Object $_.creationtime -Descending | Select -First 1 | Stop-VBRViReplicaFailback -RunAsync

    Example 2

    This command stops failback from the replica VM named "WebServer_replica". The restorepoint to revert to is represented by the $"WebServer_replica restorepoint" variable. The restore point is obtained with Get-VBRRestorePoint and assigned to the variable beforehand. The RunAsync parameter is set to bring the process to the background.

    PS C:\PS> Stop-VBRViReplicaFailback -RestorePoint $"WebServer_replica restorepoint" -RunAsync