New-VBRCloudVLANConfiguration

In this article

    Short Description

    Creates pools of VLANs that will be reserved for Veeam Cloud Connect.

    Applies to

    Platform: VMware, Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

    Requires a VCP license.

    Syntax

    This cmdlet provides 2 parameter sets.

    • For VMware:

    New-VBRCloudVLANConfiguration -Server <Object> -ViVirtualSwitch <VBRViVirtualSwitch> -FirstVLANWithInternet <int> -LastVLANWithInternet <int> -FirstVLANWithoutInternet <int> -LastVLANWithoutInternet <int>  [<CommonParameters>]

    • For Hyper-V:

    New-VBRCloudVLANConfiguration -Server <Object> -HvNetworkInfo <VBRHvServerNetworkInfo> -FirstVLANWithInternet <int> -LastVLANWithInternet <int> -FirstVLANWithoutInternet <int> -LastVLANWithoutInternet <int> [<CommonParameters>]

    Detailed Description

    This cmdlet creates a VBRCloudVLANConfiguration object. This object contains a pool of VLANs on a selected virtual switch.

    Before running this cmdlet, the service provider must pre-configure physical networks. This cmdlet reserves the selected number of networks for Veeam Cloud Connect. From this pool of the reserved networks, you can allocate quotas of networks to tenants.

    Create a separate pool of VLANs for each VMware or Hyper-V virtual switch.

    New-VBRCloudVLANConfiguration Note:

    The total number of VLANs reserved for Veeam Cloud Connect Replication must be equal to or exceed the total number all tenants' production networks.

    For more information on configuring the VLANs, see https://helpcenter.veeam.com/backup/cloud/hardware_plan_network_vlans.html.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Server

    Specifies host or cluster on which you plan to configure a replication target.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    ViVirtualSwitch

    Specifies the VMware virtual switch connected to the target host.

    Accepts VBRViVirtualSwitch type.

    True

    Named

    False

    False

    HvNetworkInfo

    Specifies the Hyper-V virtual switch connected to the target host.

    Accepts VBRHvServerNetworkInfo type.

    True

    Named

    False

    False

    FirstVLANWithInternet

    Specifies the first VLAN ID in the range of VLANs you plan to use for providing networks with internet access to VM replicas on the cloud host.

    True

    Named

    False

    False

    LastVLANWithInternet

    Specifies the last VLAN ID in the range of VLANs you plan to use for providing networks with internet access to VM replicas on the cloud host.

    True

    Named

    False

    False

    FirstVLANWithoutInternet

    Specifies the first VLAN ID in the range of VLANs you plan to use for providing networks without internet access to VM replicas on the cloud host.

    True

    Named

    False

    False

    LastVLANWithoutInternet

    Specifies the last VLAN ID in the range of VLANs you plan to use for providing networks without internet access to VM replicas on the cloud host.

    True

    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

    VBRCloudVLANConfiguration

    Example 1

    This example shows how to specify a number of VLANs on a VMware virtual switch.

    1. Run Get-VBRServer to get the host that will be the replication target. Save it to the $server variable.
    2. Run Get-VBRViVirtualSwitch to get the virtual switches on the target host. Save the array of the switches to the $switches variable.
    3. Run New-VBRCloudVLANConfiguration using the saved variables. Use the first virtual switch in the array saved to the $switches variable. Allocate a range of pre-configured networks.

    $server = Get-VBRServer –Type ESXi -Name "ESXiHost"

    $switches = Get-VBRViVirtualSwitch -Server $server

    New-VBRCloudVLANConfiguration –Server $server –ViVirtualSwitch $switches[0] –FirstVLANWithInternet 1 –LastVLANWithInternet 5 –FirstVLANWithoutInternet 6 –LastVLANWithoutInternet 10

    Example 2

    This example shows how to specify a number of VLANs on a Hyper-V virtual switch.

    1. Run Get-VBRServer to get the host that will be the replication target. Save it to the $server variable.
    2. Run Get-VBRHvServerNetworkInfo to get the virtual switches on the target host. Save the array of the switches to the $switches variable.
    3. Run New-VBRCloudVLANConfiguration using the saved variables. Use the first virtual switch in the array saved to the $switches variable. Allocate a range of pre-configured networks.

    $server = Get-VBRServer -Type HvServer -Name "Hyper-VHost"

    $switches = Get-VBRHvServerNetworkInfo -Server $server

    New-VBRCloudVLANConfiguration –Server $server -HvNetworkInfo $switches[0] –FirstVLANWithInternet 1 –LastVLANWithInternet 5 –FirstVLANWithoutInternet 6 –LastVLANWithoutInternet 10

    Related Commands

    Get-VBRServer

    Get-VBRViVirtualSwitch

    Get-VBRHvServerNetworkInfo