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

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

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

    Related Commands

    Get-VBRServer

    Get-VBRViVirtualSwitch

    Get-VBRHvServerNetworkInfo

    Return Type

    VBRCloudVLANConfiguration

    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 (by Value
    FromPipeline, ValueFromPipeline
    ByPropertyName)

    False

    ViVirtual
    Switch

    Specifies the VMware virtual switch connected to the target host.

    True

    Named

    False

    False

    HvNetwork
    Info

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

    True

    Named

    False

    False

    FirstVLAN
    WithInternet

    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

    LastVLAN
    WithInternet

    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

    FirstVLAN
    Without
    Internet

    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

    LastVLAN
    Without
    Internet

    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 about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    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.

    PS C:\PS> $server = Get-VBRServer –Type ESXi -Name "ESXiHost"

    PS C:\PS> $switches = Get-VBRViVirtualSwitch -Server $server

    PS C:\PS> 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.

    PS C:\PS> $server = Get-VBRServer -Type HvServer -Name "Hyper-VHost"

    PS C:\PS> $switches = Get-VBRHvServerNetworkInfo -Server $server

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