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

Set-VBRCloudFailoverPlanObject

In this article

    Short Description

    Modifies a selected failover plan object.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Enterprise, Enterprise Plus

    Syntax

    Set-VBRCloudFailoverPlanObject -Object <VBRCloudFailoverPlanObject> [-BootOrder <int>] [-BootDelay <int>] [-PublicIpRule <VBRFailoverPlanPublicIPRule[]>]  [<CommonParameters>]

    Related Commands

    Get-VBRFailoverPlan

    Return Type

    VBRCloudFailoverPlanObject

    Detailed Description

    This cmdlet modifies a selected failover plan object. To modify settings, you need to enter the corresponding parameters with new values. The parameters that you omit will remain unchanged.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Object

    Specifies the failover plan object you want to modify.

    True

    Named

    True (by Value
    FromPipeline,
    ValueFromPipeline
    ByPropertyName)

    False

    BootOrder

    Specifies the order number by which the replica will boot.

    False

    Named

    False

    False

    BootDelay

    Specifies the delay time for the replica to boot.

    The delay time is set in seconds.

    If omitted, the delay time will be set to 60 sec by default.

    If you set boot delay to '0' to a number of replicas, these replicas will start simultaneously.

    False

    Named

    False

    False

    Public
    IpRule

    Specifies the rule for mapping public IP and ports to the IP and ports of the replica VM.

    You can add multiple rules to this object.

    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 example shows how to change the boot order of a replica VM.

    1. Run Get-VBRRestorepoint to get the latest restore point of the replica VM you want to edit. Save it to $MSExchange01 variable.
    2. Run Set-VBRCloudFailoverPlanObject to modify the boot order of the replica VM. Use the saved variable.

    PS C:\PS> $MSExchange01 = Get-VBRRestorePoint -Name "MS_Exchange_Server_01" | Sort-Object $_.creationtime -Descending | Select -First 1 | New-VBRFailoverPlanObject -BootOrder 1

    PS C:\PS> Set-VBRCloudFailoverPlanObject -Object $MSExchange01 -BootOrder 2

    Example 2

    This example shows how to change the boot delay of a replica VM.

    1. Run Get-VBRRestorePoint to get the latest restore point of the replica VM you want to edit. Save it to $MSExchange02 variable.
    2. Run Set-VBRCloudFailoverPlanObject to modify the boot delay of the replica VM. Use the saved variable.

    PS C:\PS> $MSExchange02 = Get-VBRRestorePoint -Name "MS_Exchange_Server_02" | Sort-Object $_.creationtime -Descending | Select -First 1 | New-VBRFailoverPlanObject -BootDelay 120

    PS C:\PS> Set-VBRCloudFailoverPlanObject -Object $MSExchange02 -BootDelay 240