Help Center
Choose product document...
Veeam Backup & Replication 9.5
PowerShell Reference

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

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

False

ViVirtual
Switch

Specifies the VMware virtual switch connected to the target host.

Accepts VBRViVirtualSwitch type.

True

Named

False

False

HvNetwork
Info

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

Accepts VBRHvServerNetworkInfo type.

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.

Return Type

VBRCloudVLANConfiguration

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

Related Commands

Get-VBRServer

Get-VBRViVirtualSwitch

Get-VBRHvServerNetworkInfo

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Backup Explorers User Guide

PowerShell Reference

RESTful API Reference

Veeam Backup FREE Edition User Guide

Veeam Backup for Microsoft Office 365

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation