New-VBRViVirtualLabIPMappingRule

Short Description

Defines static IP address mapping rules.

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

Syntax

New-VBRViVirtualLabIPMappingRule -ProductionNetwork <VBRViNetworkInfo> [-IsolatedIPAddress <IPAddress>]

[-AccessIPAddress <IPAddress>] [-IsolatedIPv6Address <IPAddress>] [-AccessIPv6Address <IPAddress>]

[-Note <String>] [<CommonParameters>]

Detailed Description

This cmdlet creates the VBRViVirtualLabIPMappingRule object that defines static IP address mapping rules.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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
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
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
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
Note	Specifies notes that you want to assign to the static mapping settings.	`String`	False	Named	False
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 `VBRViNetworkInfo` object. To get this object, run the `Get-VBRViServerNetworkInfo` cmdlet.	`VBRViNetworkInfo`	True	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 VBRViVirtualLabNetworkMappingRule object that defines static IP address mapping rules.

Examples

New-VBRViVirtualLabIPMappingRule Example 1. Defining Static IPv4 Address Mapping Rules

This example shows how to define static IPv4 address mapping rules. The cmdlet output will contain the following details on mapping settings: ProductionNetwork, IsolatedIPAddress, AccessIPAddress and Note.

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

$network = Get-VBRViServerNetworkInfo -Server $server

New-VBRViVirtualLabIPMappingRule -ProductionNetwork $network[2] -IsolatedIPAddress 172.17.53.15 -AccessIPAddress 172.17.53.162 -Note "IP address to access DNS"

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRViServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRViVirtualLabIPMappingRule cmdlet. Specify the following settings:
- Set the $network[2] variable as the ProductionNetwork parameter value.
  
  The Get-VBRViServerNetworkInfo cmdlet will return an array of production networks. Mind the ordinal number of the necessary production network (An array starts with 0. In our example, it is the third production network in the array).
- Specify the IsolatedIPAddress parameter value.
- Specify the AccessIPAddress parameter value.
- Specify the Note parameter value.

New-VBRViVirtualLabIPMappingRule Example 2. Defining Static IPv6 Address Mapping Rules

This example shows how to define static IPv6 address mapping rules. The cmdlet output will contain the following details on mapping settings: ProductionNetwork, IsolatedIPAddress, AccessIPAddress and Note.

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

$network = Get-VBRViServerNetworkInfo -Server $server

New-VBRViVirtualLabIPMappingRule -ProductionNetwork $network[2] -IsolatedIPv6Address fdd1:aa80:bb80:cc80:dd80:ee80:ff80:1 -AccessIPv6Address fdd1:aa80:bb80:ac80:dd80:ee80:ff80:1 -Note "IP address to access DNS"

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRViServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRViVirtualLabIPMappingRule cmdlet. Specify the following settings:
- Set the $network[2] variable as the ProductionNetwork parameter value.
  
  The Get-VBRViServerNetworkInfo cmdlet will return an array of production networks. Mind the ordinal number of the necessary production network (An array starts with 0. In our example, it is the third production network in the array).
- Specify the IsolatedIPv6Address parameter value.
- Specify the AccessIPv6Address parameter value.
- Specify the Note parameter value.

New-VBRViVirtualLabIPMappingRule Example 3. Defining Static IPv4 and IPv6 Address Mapping Rules

This example shows how to define static IPv4 and IPv6 address mapping rules. The cmdlet output will contain the following details on mapping settings: ProductionNetwork, IsolatedIPAddress, AccessIPAddress and Note.

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

$network = Get-VBRViServerNetworkInfo -Server $server

New-VBRViVirtualLabIPMappingRule -ProductionNetwork $network[2] -IsolatedIPAddress 192.168.10.20 -AccessIPAddress 192.158.10.20 -IsolatedIPv6Address fdd1:aa80:bb80:cc80:dd80:ee80:ff80:1 -AccessIPv6Address fdd1:aa80:bb80:ac80:dd80:ee80:ff80:1 -Note "IP address to access DNS"

Perform the following steps:

Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Get-VBRViServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
Run the New-VBRViVirtualLabIPMappingRule cmdlet. Specify the following settings:
- Set the $network[2] variable as the ProductionNetwork parameter value.
  
  The Get-VBRViServerNetworkInfo cmdlet will return an array of production networks. Mind the ordinal number of the necessary production network (An array starts with 0. In our example, it is the third production network in the array).
- Specify the IsolatedIPAddress parameter value.
- Specify the AccessIPAddress parameter value.
- Specify the IsolatedIP6Address parameter value.
- Specify the AccessIPv6Address parameter value.
- Specify the Note parameter value.