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

Get-VBRFailoverPlan

On This Page

Short Description

Returns existing failover plans or cloud failover plans.

Applies to

Platform: VMware, Hyper-V

Product Edition: Enterprise, Enterprise Plus

Syntax

This cmdlet provides 4 parameter sets.

Get-VBRFailoverPlan [-Name <string[]>] [<CommonParameters>]

Get-VBRFailoverPlan -Type <VBRFailoverPlanType> {Local | Tenant | Cloud} [-Name <string[]>] [<CommonParameters>]

Get-VBRFailoverPlan -Tenant <VBRCloudTenant> [-Name <string[]>] [<CommonParameters>]

Get-VBRFailoverPlan [-Id <guid[]>] [<CommonParameters>]

Related Commands

None

Return Type

Detailed Description

This cmdlet returns existing failover plans or cloud failover plans.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Name	Specifies the array of names of the failover plans you want to get or search conditions.	False	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	True
Tenant	Specifies the cloud tenant. The cmdlet will return failover plans created by this tenant.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
Type	Specifies the type of the failover plan: Local: non-cloud failover plans. Cloud: [for cloud user] cloud failover plans. Tenant: [for cloud provider] cloud failover plans created by cloud user. The cmdlet will return the failover plans of the selected type.	True	Named	False	False
Id	Specifies the array of IDs of the VBRFailoverPlan object you want to add to the failover plan. Accepts GUID or string type.	False	Named	True (by ValueFromPipeline ByPropertyName)	False

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 looks for the list of all existing failover plans.

PS C:\PS> Get-VBRFailoverPlan

Example 2

This command looks for a failover plan named "MS Exchange Group Failover".

PS C:\PS> Get-VBRFailoverPlan -Name "MS Exchange Group Failover"

Example 3

[Cloud] This command gets all cloud failover plans.

PS C:\PS> Get-VBRFailoverPlan –Type Cloud

Example 4

[Cloud provider] This command gets failover plan named "MS Exchange Group Failover" created by the ABC Company tenant.

Run Get-VBRCloudTenant to get the ABC Company tenant and save it to the $tenant variable.
Run Get-VBRFailoverPlan with the $tenant variable.

PS C:\PS> $tenant = Get-VBRCloudTenant -Name "ABC Company"

PS C:\PS> Get-VBRFailoverPlan -Tenant $tenant -Name "MS Exchange Group Failover"