---
title: "New-VBRCloudVLANConfiguration"
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."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrcloudvlanconfiguration.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Cloud Connect > Veeam Cloud Connect Hardware Plans > New-VBRCloudVLANConfiguration"
dateModified: "2026-08-19"
---

# New-VBRCloudVLANConfiguration

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

**Platform**: VMware, Hyper-V

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

Requires a VCP license.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Vi</code></p>

```
New-VBRCloudVLANConfiguration -Server <Object> -ViVirtualSwitch <VBRViVirtualSwitch>
 -FirstVLANWithInternet <Int32> -LastVLANWithInternet <Int32> -FirstVLANWithoutInternet <Int32>
 -LastVLANWithoutInternet <Int32> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Hv</code></p>

```
New-VBRCloudVLANConfiguration -Server <Object> -HvNetworkInfo <VBRHvServerNetworkInfo>
 -FirstVLANWithInternet <Int32> -LastVLANWithInternet <Int32> -FirstVLANWithoutInternet <Int32>
 -LastVLANWithoutInternet <Int32> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates a [`VBRCloudVLANConfiguration`](vbrcloudvlanconfiguration.md) 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.

::: 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](https://helpcenter.veeam.com/docs/backup/cloud/hardware_plan_network_vlans.html?ver=120) section in the Veeam Backup & Replication User Guide.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">FirstVLANWithInternet</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">FirstVLANWithoutInternet</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HvNetworkInfo</span></p>
        </td>
        <td>
          <p>Specifies the Hyper-V virtual switch connected to the target host.</p><p>Accepts the <a href="vbrhvservernetworkinfo.md"><code>VBRHvServerNetworkInfo</code></a> object. To get this object, run the <a href="get-vbrhvservernetworkinfo.md"><code>Get-VBRHvServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrhvservernetworkinfo.md"><code>VBRHvServerNetworkInfo</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LastVLANWithInternet</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LastVLANWithoutInternet</span></p>
        </td>
        <td>
          <p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>Specifies host or cluster on which you plan to configure a replication target.</p><p>Accepts the <code>CHost</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>Object</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ViVirtualSwitch</span></p>
        </td>
        <td>
          <p>Specifies the VMware virtual switch connected to the target host.</p><p>Accepts the <a href="vbrvivirtualswitch.md"><code>VBRViVirtualSwitch</code></a> object. To get this object, run the <a href="get-vbrvivirtualswitch.md"><code>Get-VBRViVirtualSwitch</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvivirtualswitch.md"><code>VBRViVirtualSwitch</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
[`VBRCloudVLANConfiguration`](vbrcloudvlanconfiguration.md)

## Examples

::: example
### 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:

1. Run the [`Get-VBRServer`](get-vbrserver.md) 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`](get-vbrvivirtualswitch.md) 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).

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

:::

::: example
### 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:

1. Run the [`Get-VBRServer`](get-vbrserver.md) 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`](get-vbrhvservernetworkinfo.md) 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).

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

- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRViVirtualSwitch`](get-vbrvivirtualswitch.md)
- [`Get-VBRHvServerNetworkInfo`](get-vbrhvservernetworkinfo.md)