---
title: "New-VBRViNetworkMappingRule"
description: "Defines network mapping rules of isolated networks. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet creates the VBRViVirtualLabNetworkMappingRule object that defines network mapping rules of isolated networ"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrvinetworkmappingrule.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > SureBackup > SureBackup Virtual Labs > New-VBRViNetworkMappingRule"
dateModified: "2026-08-19"
---

# New-VBRViNetworkMappingRule

## Short Description
Defines network mapping rules of isolated networks.

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

## Syntax
```
New-VBRViNetworkMappingRule -Server <CHost> -ProductionNetwork <VBRViNetworkInfo> -IsolatedNetworkName <String>
 [-VLANID <Int32>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the `VBRViVirtualLabNetworkMappingRule` object that defines network mapping rules of isolated networks. Veeam Backup & Replication will map isolated networks to production networks that are specified in this rule.

You can use this object to specify network mapping rules in network settings of isolated networks.

Run the [`New-VBRViVirtualLabNetworkOptions`](new-vbrvivirtuallabnetworkoptions.md) cmdlet to specify network settings of isolated networks.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">IsolatedNetworkName</span></p>
        </td>
        <td>
          <p>Specifies a name of an isolated network. The cmdlet will create an isolated network with this name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ProductionNetwork</span></p>
        </td>
        <td>
          <p>Specifies a production network with original VMs. The cmdlet will map VMs from this network to VMs from the isolated network.</p><p>Accepts the <code>VBRViNetworkInfo</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>Specifies an ESXi host. The cmdlet will define a network mapping rule for the virtual lab that is added to this host.</p><p>Accepts the <code>CHost</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">VLANID</span></p>
        </td>
        <td>
          <p>Specifies an ID of an isolated network. The cmdlet will create the isolated network with the specified ID.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

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 `VBRViVirtualLabNetworkMappingRule` object that defines network mapping rules of isolated networks.

## Examples

::: example
### Defining Isolated Mapping Rules

This example shows how to define network mapping rules of isolated networks. The cmdlet output will show details on the following network settings: `ProductionNetwork`, `IsolatedNetworkName` and `VLANID`.

```
$server = Get-VBRServer -Name "srv01.tech.local"
$network = Get-VBRViServerNetworkInfo -Server $server
New-VBRViNetworkMappingRule -Server $server -ProductionNetwork $network[3] -IsolatedNetworkName "Sandbox01 Private VM Network" -VLANID 5
ProductionNetwork                       IsolatedNetworkName                                                  VLANID
-----------------                       -------------------                                                  ------
Veeam.Backup.PowerShell.Infos.VBRViN... Sandbox01 Private VM Network                                              5
```

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` cmdlet. Specify the following settings:

   - Set the `$server` variable as the `Server` parameter value.
   - Set the `$network[3]` 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 fourth production network in the array).

   - Specify the `IsolatedNetworkName` parameter value.
   - Specify the `VLANID` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md)