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

New-VBRCloudVLANConfiguration

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

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.

Run Get-VBRServer to get the host that will be the replication target. Save it to the $server variable.
Run Get-VBRViVirtualSwitch to get the virtual switches on the target host. Save the array of the switches to the $switches variable.
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.

Run Get-VBRServer to get the host that will be the replication target. Save it to the $server variable.
Run Get-VBRHvServerNetworkInfo to get the virtual switches on the target host. Save the array of the switches to the $switches variable.
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