This is an archive version of the document. To get the most up-to-date information, see the current version.

New-VBRViVirtualLabIPMappingRule

Short Description

Defines static IP address mapping rules.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus

Syntax

New-VBRViVirtualLabIPMappingRule -ProductionNetwork <VBRViNetworkInfo> -IsolatedIPAddress <ipaddress> -AccessIPAddress <ipaddress> [-Note <string>]  [<CommonParameters>]

Detailed Description

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

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

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.

True

Named

False

IsolatedIPAddress

Specifies an IP address of an isolated network. The cmdlet will map this IP address with an IP address of a production network.

IPAddress

True

Named

False

AccessIPAddress

Specifies an IP address of a production network. The cmdlet will map this IP address with an IP address of an isolated network.

IPAddress

True

Named

False

Note

Specifies notes that you want to assign to the static mapping settings.

String

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

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

Defining Static IP Address Mapping Rules

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

$server = Get-VBRServer -Name "srv01.veeam.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"

ProductionNetwork             IsolatedIPAddress             AccessIPAddress               Note

-----------------             -----------------             ---------------               ----

Veeam.Backup.PowerShell.In... 172.17.53.15                  172.17.53.162                 IP address to access DNS

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-VBRViServerNetworkInfo cmdlet. Set the $server variable as the Server parameter value. Save the result to the $network variable.
  3. 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 value.
  • Specify the AccessIPAddress value.
  • Specify the Note parameter value.

Related Commands