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, Veeam Universal License

    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 appliances 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

    HardwarePlanOptions

    Specifies the hardware plan options.

    Accepts VBRCloudTenantHwPlanOptions type.

    False

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    EnableNetworkFailoverResources

    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

    EnablePublicIp

    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

    NumberOfPublicIp

    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

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.