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

New-VBRCloudTenantReplicationResources

In this article

Short Description

Creates VBRCloudTenantReplicationResources objects that contain replication resources.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

New-VBRCloudTenantReplicationResources -HardwarePlanOptions <VBRCloudTenantHwPlanOptions[]> [-EnableNetworkFailoverResources] [-EnablePublicIp] [-NumberOfPublicIp <int>] [<CommonParameters>]

Detailed Description

This cmdlet creates a new VBRCloudTenantReplicationResources object. This object contains the cloud tenant replication resources.

To provide network access to cloud replicas, you need to configure a network extension appliance. You have the following options:

Default network extension appliance. If you enable the the failover resources in this cmdlet, the network extension appliance will be created automatically. The network appliance will have default settings.
Customize the default network appliance. After the network appliance is created automatically, you can change its settings. For details, see Tenant Network Appliances.
Do not configure a network appliance. The tenant may deploy the network extension appliance(s) manually on their side.

To allocate a number of public IP addresses, you need to pre-configure the public IP addresses pool. For details, see Public IP Addresses.

Parameters

Parameter	Description	Required	Position	Accept Pipeline Input	Accept Wildcard Characters
Hardware PlanOptions	Specifies the hardware plan options. Accepts VBRCloudTenantHwPlanOptions object.	True	Named	True (by Value FromPipeline, ValueFromPipeline ByPropertyName)	False
Enable Network Failover Resources	Indicates that the tenant will be able to use the built-in failover networking management capabilities. The cmdlet will create a network extension appliance with default settings.	False	Named	False	False
Enable PublicIp	Indicates that the tenant can use a range of public IP addresses. Use the NumberOfPublicIp parameter to set the maximum number of IPs. Default: 0.	False	Named	False	False
NumberOf PublicIp	Specifies the maximum number of public IPs for the tenant. Accepts values from 1 to 9999.	False	Named	False	False

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

Related Commands

New-VBRCloudTenantHwPlanOptions

Return Type

VBRCloudTenantReplicationResources

Example 1

This example shows how to create an object containing replication resources with enabled failover capabilities.

Run Get-VBRCloudHardwarePlan to get the hardware plan. Save it to the $HwPlan variable.
Run New-VBRCloudTenantHwPlanOptions using the $HwPlan variable. Save the result to the $options variable.
Run New-VBRCloudTenantReplicationResources and use the $options variable. Save the result to the $resources variable for further use.

PS C:\PS> $HwPlan = Get-VBRCloudHardwarePlan -Name "VMware Silver"

PS C:\PS> $options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan

PS C:\PS> $resources = New-VBRCloudTenantReplicationResources -EnableNetworkFailoverResources -HardwarePlanOptions $options

Example 2

This example shows how to create an object containing replication resources with enabled failover capabilities and allocate 5 public IP addresses.

Pre-configure a pool of public IP addresses that contains not less then 5 addresses. For details, see Public IP Addresses.
Run Get-VBRCloudHardwarePlan to get the hardware plan. Save it to the $HwPlan variable.
Run New-VBRCloudTenantHwPlanOptions using the $HwPlan variable. Save the result to the $options variable.
Run New-VBRCloudTenantReplicationResources and use the $options variable. Save the result to the $resources variable for further use.

PS C:\PS> $HwPlan = Get-VBRCloudHardwarePlan -Name "VMware Silver"

PS C:\PS> $options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan

PS C:\PS> $resources = New-VBRCloudTenantReplicationResources -EnableNetworkFailoverResources -HardwarePlanOptions $options -EnablePublicIp -NumberOfPublicIp 5