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

New-VBRCloudTenantReplicationResources

Short Description

Creates VBRCloudTenantReplicationResources objects that contain replication resources.

Applies to

Platform: VMware, Hyper-V

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

New-VBRCloudTenantReplicationResources [-EnableNetworkFailoverResources] [-HardwarePlanOptions <VBRCloudTenantHwPlanOptions[]>] [-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 Set-VBRCloudTenantNetworkAppliance.
  • 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 Add-VBRCloudPublicIP.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Hardware
PlanOptions

Specifies the hardware plan options.

Accepts VBRCloudTenantHwPlanOptions type.

False

Named

True (ByValue,
ByProperty
Name)

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.

Permitted values: from 1 to 9999.

False

Named

False

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Return Type

VBRCloudTenantReplicationResources

Example 1

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

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

$HwPlan = Get-VBRCloudHardwarePlan -Name "VMware Silver"

$options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan

$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.

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

$HwPlan = Get-VBRCloudHardwarePlan -Name "VMware Silver"

$options = New-VBRCloudTenantHwPlanOptions -HardwarePlan $HwPlan

$resources = New-VBRCloudTenantReplicationResources -EnableNetworkFailoverResources -HardwarePlanOptions $options -EnablePublicIp -NumberOfPublicIp 5

Related Commands

New-VBRCloudTenantHwPlanOptions