--- title: "Set-VBRViVirtualLabNetworkOptions" description: "Modifies network settings of isolated networks. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet modifies network settings of isolated networks and how to map it to production networks." canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrvivirtuallabnetworkoptions.html" breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Virtual Labs > Set-VBRViVirtualLabNetworkOptions" dateModified: "2026-08-19" --- # Set-VBRViVirtualLabNetworkOptions ## Short Description Modifies network settings of isolated networks. **Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License ## Syntax ``` Set-VBRViVirtualLabNetworkOptions -Options [-NetworkMappingRule ] [-IPAddress ] [-SubnetMask ] [-MasqueradeIPAddress ] [-DNSServer ] [-EnableDHCP] [-IPv6Address ] [-IPv6PrefixLength ] [-MasqueradeIPv6Address ] [-IPv6DNSServer ] [-EnableDHCPv6] [] ``` ## Detailed Description This cmdlet modifies network settings of isolated networks and how to map it to production networks. ::: note To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged. ::: ## Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

DNSServer

Specifies an array of IP 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.

SwitchParameter

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.

SwitchParameter

False

Named

False

IPAddress

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

IPAddress

False

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

False

Named

False

IPv6DNSServer

Specifies an array of IPv6 addresses of virtualized DNS servers.

IPAddress[]

False

Named

False

IPv6PrefixLength

Specifies a prefix length of an isolated network.

Int32

False

Named

False

MasqueradeIPAddress

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

IPAddress

False

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

False

Named

False

NetworkMappingRule

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 VBRViVirtualLabNetworkMappingRule object. To create this object, run the New-VBRViNetworkMappingRule cmdlet.

VBRViVirtualLabNetworkMappingRule

False

Named

False

Options

Specifies network settings that you want to modify.

Accepts the VBRViVirtualLabNetworkOptions object. To create this object, run the New-VBRViVirtualLabNetworkOptions cmdlet.

VBRViVirtualLabNetworkOptions

True

Named

True (ByPropertyName, ByValue)

SubnetMask

Specifies a subnet mask of an isolated network.

String

False

Named

False

`` 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 The cmdlet returns the `VBRViVirtualLabNetworkOption` object that defines network settings of isolated networks and how to map it to production networks. ## Examples ::: example ### Example 1. Modifying Subnet Mask This example shows how to modify a subnet mask of an isolated network that connects to the to production network. ``` $server = Get-VBRServer -Name "srv01.tech.local" $network = Get-VBRViServerNetworkInfo -Server $server $maprule = New-VBRViNetworkMappingRule -ProductionNetwork $network[3] -IsolatedNetworkName "Sandbox01 Private VM Network" -VLANID 5 $isolated = New-VBRViVirtualLabNetworkOptions -NetworkMappingRule $maprule -IPAddress 172.17.1.2 -SubnetMask 255.255.0.0 -MasqueradeIPAddress 172.22.22.22 Set-VBRViVirtualLabNetworkOptions -Options $isolated -SubnetMask 255.255.255.0 ``` Perform the following steps: 1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable. 2. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$network` variable. 3. Run the [`New-VBRViNetworkMappingRule`](new-vbrvinetworkmappingrule.md) cmdlet. Specify the `ProductionNetwork`, `IsolatedNetworkName` and `VLANID` parameter values. Save the result to the `$maprule` variable. 4. Run the [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md) cmdlet. Specify the `NetworkMappingRule`, `IPAddress`, `SubnetMask` and `MasqueradeIPAddress` parameter values. Save the result to the `$isolated` variable. 5. Run the `Set-VBRViVirtualLabNetworkOptions` cmdlet. Set the `$isolated` variable as the `Options` parameter value. Specify the `SubnetMask` parameter value. ::: ::: example ### Example 2. Modifying Prefix Length This example shows how to modify a prefix length of an isolated network that connects to the to production network. ``` $server = Get-VBRServer -Name "srv01.tech.local" $network = Get-VBRViServerNetworkInfo -Server $server $maprule = New-VBRViNetworkMappingRule -ProductionNetwork $network[3] -IsolatedNetworkName "Sandbox01 Private VM Network" -VLANID 5 $isolated = New-VBRViVirtualLabNetworkOptions -NetworkMappingRule $maprule -IPv6Address fdd1:aa80:bb80:cc80:dd80:ee80:fe80:10 -IPv6PrefixLength 64 -MasqueradeIPv6Address fdd1:ab80:bb80:cc88:: Set-VBRViVirtualLabNetworkOptions -Options $isolated -IPv6PrefixLength 64 ``` Perform the following steps: 1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable. 2. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$network` variable. 3. Run the [`New-VBRViNetworkMappingRule`](new-vbrvinetworkmappingrule.md) cmdlet. Specify the `ProductionNetwork`, `IsolatedNetworkName` and `VLANID` parameter values. Save the result to the `$maprule` variable. 4. Run the [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md) cmdlet. Specify the `NetworkMappingRule`, `IPv6Address`, `IPv6PrefixLength` and `MasqueradeIPv6Address` parameter values. Save the result to the `$isolated` variable. 5. Run the `Set-VBRViVirtualLabNetworkOptions` cmdlet. Set the `$isolated` variable as the `Options` parameter value. Specify the new `IPv6PrefixLength` parameter value. ::: ::: example ### Example 3. Modifying IP of Proxy Appliance This example shows how to modify an IP address of a proxy appliance to which an isolated network is connected. The isolated network will connect to the proxy appliance that has the `172.17.1.7` IP address. ``` $server = Get-VBRServer -Name "srv01.tech.local" $network = Get-VBRViServerNetworkInfo -Server $server $maprule = New-VBRViNetworkMappingRule -ProductionNetwork $network[3] -IsolatedNetworkName "Sandbox01 Private VM Network" -VLANID 5 $isolated = New-VBRViVirtualLabNetworkOptions -NetworkMappingRule $maprule -IPAddress 172.17.1.2 -SubnetMask 255.255.0.0 -MasqueradeIPAddress 172.22.22.22 Set-VBRViVirtualLabNetworkOptions -Options $isolated -IPAddress 172.17.1.7 ``` Perform the following steps: 1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable. 2. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$network` variable. 3. Run the [`New-VBRViNetworkMappingRule`](new-vbrvinetworkmappingrule.md) cmdlet. Specify the `ProductionNetwork`, `IsolatedNetworkName` and `VLANID` parameter values. Save the result to the `$maprule` variable. 4. Run the [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md) cmdlet. Specify the `NetworkMappingRule`, `IPAddress`, `SubnetMask` and `MasqueradeIPAddress` parameter values. Save the result to the `$isolated` variable. 5. Run the `Set-VBRViVirtualLabNetworkOptions` cmdlet. Set the `$isolated` variable as the `Options` parameter value. Specify the `IPAddress` parameter value. ::: ::: example ### Example 4. Modifying Masquerade IP Address This example shows how to modify a masquerade IP address of an isolated network that connect to the production network. ``` $server = Get-VBRServer -Name "srv01.tech.local" $network = Get-VBRViServerNetworkInfo -Server $server $maprule = New-VBRViNetworkMappingRule -ProductionNetwork $network[3] -IsolatedNetworkName "Sandbox01 Private VM Network" -VLANID 5 $isolated = New-VBRViVirtualLabNetworkOptions -NetworkMappingRule $maprule -IPAddress 172.17.1.2 -SubnetMask 255.255.0.0 -MasqueradeIPAddress 172.22.22.22 Set-VBRViVirtualLabNetworkOptions -Options $isolated -MasqueradeIPAddress 172.22.22.24 ``` Perform the following steps: 1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable. 2. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$network` variable. 3. Run the [`New-VBRViNetworkMappingRule`](new-vbrvinetworkmappingrule.md) cmdlet. Specify the `ProductionNetwork`, `IsolatedNetworkName` and `VLANID` parameter values. Save the result to the `$maprule` variable. 4. Run the [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md) cmdlet. Specify the `NetworkMappingRule`, `IPAddress`, `SubnetMask` and `MasqueradeIPAddress` parameter values. Save the result to the `$isolated` variable. 5. Run the `Set-VBRViVirtualLabNetworkOptions` cmdlet. Set the `$isolated` variable as the `Options` parameter value. Specify the `MasqueradeIPAddress` parameter value. ::: ## Related Commands - [`Get-VBRServer`](get-vbrserver.md) - [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) - [`New-VBRViNetworkMappingRule`](new-vbrvinetworkmappingrule.md) - [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md)