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 parameter sets that allow you to:

Create a pool of VLANs for VMware.

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

Create a pool of VLANs for Hyper-V.

New-VBRCloudVLANConfiguration -Server <Object> -HvNetworkInfo <VBRHvServerNetworkInfo> -FirstVLANWithInternet <int32> -LastVLANWithInternet <int32> -FirstVLANWithoutInternet <int32> -LastVLANWithoutInternet <int32> [<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 the Managing VLANs section in the Veeam Backup & Replication User Guide.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Server	Specifies host or cluster on which you plan to configure a replication target.	Accepts the CHost object. To get this object, run the Get-VBRServer cmdlet.	True	Named	True (ByValue, ByProperty Name)
ViVirtualSwitch	Specifies the VMware virtual switch connected to the target host.	Accepts the VBRViVirtualSwitch object. To get this object, run the Get-VBRViVirtualSwitch cmdlet.	True	Named	False
HvNetworkInfo	Specifies the Hyper-V virtual switch connected to the target host.	Accepts the VBRHvServerNetworkInfo object. To get this object, run the Get-VBRHvServerNetworkInfo cmdlet.	True	Named	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.	Int32	True	Named	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.	Int32	True	Named	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.	Int32	True	Named	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.	Int32	True	Named	False

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRCloudVLANConfiguration

Examples

New-VBRCloudVLANConfiguration Example 1. Configuring VLANs on VMware Virtual Switch

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

$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

Perform the following steps:

Run the Get-VBRServer to get the host that will be the replication target. Specify the Type and the Name parameter values. Save it to the $server variable.
Run the Get-VBRViVirtualSwitch cmdlet. Set the $server variable as the Server parameter value. Save the array of the switches to the $switches variable.

Mind the ordinal number of the necessary virtual switch (in our example, it is the first virtual switch in the array).

Run the New-VBRCloudVLANConfiguration cmdlet. Specify the following settings:

Set the $server variable as the Server parameter value.
Set the $switches variable as the ViVirtualSwitch parameter value.
Specify the FirstVLANWithInternet and the LastVLANWithInternet parameter values.
Specify the FirstVLANWithoutInternet and the LastVLANWithoutInternet parameter values.

New-VBRCloudVLANConfiguration Example 2. Configuring VLANs on Hyper-V Virtual Switch

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

$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

Perform the following steps:

Run the Get-VBRServer cmdlet to get the host that will be the replication target. Specify the Type and the Name parameter values. Save it to the $server variable.
Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the array of the switches to the $switches variable.

Mind the ordinal number of the necessary virtual switch (in our example, it is the first virtual switch in the array).

Run the New-VBRCloudVLANConfiguration cmdlet. Specify the following settings:

Set the $server variable as the Server parameter value.
Set the $switches variable as the HvNetworkInfo parameter value.
Specify the FirstVLANWithInternet and the LastVLANWithInternet parameter values.
Specify the FirstVLANWithoutInternet and the LastVLANWithoutInternet parameter values.

Related Commands