New-VBRHvIsolatedNetworkOptions

Short Description

Defines network settings of isolated networks.

Applies to

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

Syntax

New-VBRHvIsolatedNetworkOptions -ProductionNetworkOptions <VBRHvProductionNetworkOptions[]> -IsolatedNetworkName <string> [-IsolatedNetworkVLANID <int>] [-IPAddress <ipaddress>] [-SubnetMask <string>] [-MasqueradeIPAddress <ipaddress>] [-DNSServer <ipaddress[]>] [-EnableDHCP] [-IPv6Address <ipaddress>] [-IPv6PrefixLength <int>] [-MasqueradeIPv6Address <ipaddress>] [-IPv6DNSServer <ipaddress[]>] [-EnableDHCPv6]  [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRHvIsolatedNetworkOptions object that defines network settings of isolated networks and how to map it to production networks.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

ProductionNetworkOptions

Specifies a network mapping rule of an isolated network. The cmdlet will map the isolated network to the production network that is specified in this rule.

Accepts the VBRHvProductionNetworkOptions[] object. To create this object, run the New-VBRHvProductionNetworkOptions cmdlet.

True

Named

True (ByValue,
ByProperty
Name)

IsolatedNetworkName

Specifies a name of an isolated network. The cmdlet will create an isolated network with this name.

String

True

Named

False

IsolatedNetworkVLANID

Specifies an ID of a isolated network. The cmdlet will create the isolated network with the specified ID.

Int

False

Named

False

IPAddress

Specifies an IPv4 address of the proxy appliance. Veeam Backup & Replication will use this IP address to connect an isolated network with the production network.

IPAddress

True

Named

False

IPv6Address

Specifies an IPv6 address of the proxy appliance. Veeam Backup & Replication will use this IP address to connect an isolated network with the production network.

IPAddress

True

Named

False

SubnetMask

Specifies a subnet mask of an isolated network.

String

True

Named

False

IPv6PrefixLength

Specifies a prefix length of an isolated network.

<int>

False

Named

False

MasqueradeIPAddress

Specifies a masquerade IPv4 address. Veeam Backup & Replication will use this IP address to access VMs in the isolated network from the production network.

IPAddress

True

Named

False

MasqueradeIPv6Address

Specifies a masquerade IPv6 address. Veeam Backup & Replication will use this IP address to access VMs in the isolated network from the production network.

IPAddress

True

Named

False

DNSServer

Specifies an array of IPv4 addresses of virtualized DNS servers.

IPAddress[]

False

Named

False

IPv6DNSServer

Specifies an array of IPv6 addresses of virtualized DNS servers.

IPAddress[]

False

Named

False

EnableDHCP

Defines that the cmdlet will enable the DHCP service.

If you provide this parameter, Veeam Backup & Replication will dynamically assign IP addresses for isolated VMs. Otherwise, you must assign the IP addresses manually.

SwitchParamter

False

Named

False

EnableDHCPv6

Defines that the cmdlet will enable the DHCPv6 service.

If you provide this parameter, Veeam Backup & Replication will dynamically assign IP addresses for isolated VMs. Otherwise, you must assign the IP addresses manually.

SwitchParamter

False

Named

False

<CommonParameters>

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

Output Object

The cmdlet returns the VBRHvIsolatedNetworkOptions object that defines network settings of isolated networks and how to map it to production networks.

Examples

New-VBRHvIsolatedNetworkOptionsExample 1. Defining Network Settings of Isolated Network Using IPv4

This example shows how to define network settings of the Sandbox01 Private VM Network isolated network to map to the production network using IPv4. The isolated network will be set up with the following settings:

  • The IP address of the proxy appliance is assigned to 172.17.1.2.
  • The subnet mask is set to 255.255.0.0.
  • The masquerade IP address is set to 172.22.22.22.

 

$server = Get-VBRServer -Name "srv01.tech.local"

$network = Get-VBRHvServerNetworkInfo -Server $server

$prodnet = New-VBRHvProductionNetworkOptions -ProductionNetwork $network[3] -UseProductionNetworkVLANID -ProductionNetworkVLANID "2"

New-VBRHvIsolatedNetworkOptions -ProductionNetworkOptions $prodnet -IPAddress 172.17.1.2 -SubnetMask 255.255.0.0 -MasqueradeAddress 172.22.22.22

Perform the following steps:

  1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
  2. Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
  3. Run the New-VBRHvProductionNetworkOptions cmdlet. Specify the ProductionNetwork and ProductionNetworkVLANID parameters. Provide the UseProductionNetworkVLANID parameter. Save the result to the $prodnet variable.
  4. Run the New-VBRHvIsolatedNetworkOptions cmdlet. Specify the following settings:
  • Set the $prodnet variable as the ProductionNetworkOptions parameter value.
  • Specify the IPAddress parameter value.
  • Specify the SubnetMask parameter value.
  • Specify the MasqueradeIPAddress parameter value.

New-VBRHvIsolatedNetworkOptionsExample 2. Defining Network Settings of Isolated Network Using IPv6

This example shows how to define network settings of the Sandbox01 Private VM Network isolated network to map to the production network using IPv6. The isolated network will be set up with the following settings:

  • The IP address of the proxy appliance is assigned the fdd1:aa80:bb80:cc80:dd80:ee80:fe80:10 IP.
  • The prefix length is set to 64.
  • The masquerade IP address is set to fdd1:ab80:bb80:cc88::.

 

$server = Get-VBRServer -Name "srv01.tech.local"

$network = Get-VBRHvServerNetworkInfo -Server $server

$prodnet = New-VBRHvProductionNetworkOptions -ProductionNetwork $network[3] -UseProductionNetworkVLANID -ProductionNetworkVLANID "2"

New-VBRHvIsolatedNetworkOptions -ProductionNetworkOptions $prodnet -IPv6Address fdd1:aa80:bb80:cc80:dd80:ee80:fe80:10 -IPv6PrefixLength 64 -MasqueradeIPv6Address fdd1:ab80:bb80:cc88::

Perform the following steps:

  1. Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
  2. Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
  3. Run the New-VBRHvProductionNetworkOptions cmdlet. Specify the ProductionNetwork and ProductionNetworkVLANID parameters. Provide the UseProductionNetworkVLANID parameter. Save the result to the $prodnet variable.
  4. Run the New-VBRHvIsolatedNetworkOptions cmdlet. Specify the following settings:
  • Set the $prodnet variable as the ProductionNetworkOptions parameter value.
  • Specify the IPv6Address parameter value.
  • Specify the IPv6PrefixLength parameter value.
  • Specify the MasqueradeIv6PAddress parameter value.