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

<CommonParameters>

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

Output Object

VBRCloudVLANConfiguration

Examples

New-VBRCloudVLANConfigurationExample 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:

  1. 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.
  2. 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).

  1. 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-VBRCloudVLANConfigurationExample 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:

  1. 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.
  2. 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).

  1. 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