Set-VBRHvVirtualLabStaticIPMappingRule

Short Description

Modifies static IP address mapping rules for Hyper-V virtual lab.

Applies to

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

Syntax

Set-VBRHvVirtualLabIPMappingRule -Rule <VBRHvVirtualLabIPMappingRule> [-ProductionNetwork <VBRHvServerNetworkInfo>] [-IsolatedIPAddress <ipaddress>] [-AccessIPAddress <ipaddress>] [-IsolatedIPv6Address <ipaddress>] [-AccessIPv6Address <ipaddress>] [-Note <string>] [<CommonParameters>]

Detailed Description

This cmdlet modifies static IP address mapping rules for Hyper-V virtual lab.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Rule	Specifies a static IP mapping rule that you want to modify.	Accepts the VBRHvVirtualLabStaticIPMappingRule object. To create this object, run the New-VBRHvVirtualLabStaticIPMappingRule cmdlet.	True	Named	True (ByValue, ByProperty Name)
ProductionNetwork	Specifies a production network with original VMs. The cmdlet will set up static mapping of IP address from this network with IP addresses from the isolated network.	Accepts the VBRHvServerNetworkInfo object. To get this object, run the Get-VBRHvServerNetworkInfo cmdlet.	False	Named	False
IsolatedIPAddress	Specifies an IPv4 address of an isolated network. The cmdlet will map this IP address with an IP address of a production network.	IPAddress	False	Named	False
AccessIPAddress	Specifies an IPv4 address of a production network. The cmdlet will map this IP address with an IP address of an isolated network.	IPAddress	False	Named	False
IsolatedIPv6Address	Specifies an IPv6 address of an isolated network. The cmdlet will map this IP address with an IP address of a production network.	IPAddress	False	Named	False
AccessIPv6Address	Specifies an IPv6 address of a production network. The cmdlet will map this IP address with an IP address of an isolated network.	IPAddress	False	Named	False
Note	Specifies notes that you want to assign to the static mapping settings.	String	False	Named	False

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

Output Object

The cmdlet returns the VBRHvVirtualLabStaticIPMappingRule object that defines static IP address mapping rules.

Examples

Set-VBRHvVirtualLabStaticIPMappingRule Example 1. Modifying IPv4 Address of Isolated Network

This example shows how to modify an IPv4 address of isolated network for a static IP address mapping rule. The 172.17.53.75 IP of the isolated network will be mapped with the 172.17.53.162 IP address of the production network.

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

$network = Get-VBRHvServerNetworkInfo -Server $server

$mapping = New-VBRHvVirtualLabStaticIPMappingRule -ProductionNetwork $network[2] -IsolatedIPAddress 172.17.53.15 -AccessIPAddress 172.17.53.162

Set-VBRHvVirtualLabStaticIPMappingRule -Rule $mapping -IsolatedIPAddress 172.17.53.75

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRHvVirtualLabStaticIPMappingRule cmdlet. Specify ProductionNetwork, IsolatedIPAddress and AccessIPAddress parameters. Save the result to the $mapping variable.
Run the Set-VBRHvVirtualLabStaticIPMappingRule cmdlet. Set the $mapping variable as the Rule parameter value. Specify the IsolatedIPAddress parameter value.

Set-VBRHvVirtualLabStaticIPMappingRule Example 2. Modifying IPv6 Address of Isolated Network

This example shows how to modify an IPv6 address of isolated network for a static IP address mapping rule. The fdd1:ab80:bb80:cc80:dd80:ee80:ff80:1 IP of the isolated network will be mapped with the fdd1:aa80:bb80:ac80:dd80:ee80:ff80:1 IP address of the production network.

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

$network = Get-VBRHvServerNetworkInfo -Server $server

$mapping = New-VBRHvVirtualLabStaticIPMappingRule -ProductionNetwork $network[2] -IsolatedIPv6Address fdd1:aa80:bb80:cc80:dd80:ee80:ff80:1 -AccessIPv6Address fdd1:aa80:bb80:ac80:dd80:ee80:ff80:1

Set-VBRHvVirtualLabStaticIPMappingRule -Rule $mapping AccessIPv6Address fdd1:ab80:bb80:cc80:dd80:ee80:ff80:1

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRHvVirtualLabStaticIPMappingRule cmdlet. Specify ProductionNetwork, IsolatedIPv6Address and AccessIPv6Address parameters. Save the result to the $mapping variable.
Run the Set-VBRHvVirtualLabStaticIPMappingRule cmdlet. Set the $mapping variable as the Rule parameter value. Specify the AccessIPv6Address parameter value.

Set-VBRHvVirtualLabStaticIPMappingRule Example 3. Modifying IPv4 Address of Production Network

This example shows how to modify an IPv4 address of a production network for a static IP address mapping rule. The 172.17.53.15 IP of the isolated network will be mapped with the 172.17.53.170 IP address of the production network.

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

$network = Get-VBRHvServerNetworkInfo -Server $server

$mapping = New-VBRHvVirtualLabStaticIPMappingRule -ProductionNetwork $network[2] -IsolatedIPAddress 172.17.53.15 -AccessIPAddress 172.17.53.162

Set-VBRViVirtualLabIPMappingRule -Rule $mapping -AccessIPAddress 172.17.53.170

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRHvServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRHvVirtualLabStaticIPMappingRule cmdlet. Specify ProductionNetwork, IsolatedIPAddress and AccessIPAddress parameters.
Run the Set-VBRHvVirtualLabStaticIPMappingRule cmdlet. Set the $mapping variable as the Rule parameter value. Specify the AccessIPAddress parameter value.