---
title: "New-VBRHvInstantRecoveryNetworkMappingRule"
description: "Creates a new network mapping rule. Platform: Hyper-V Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet defines the VBRHvInstantRecoveryNetworkMappingRule object."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrhvinstantrecoverynetworkmappingrule.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Instant Recovery > New-VBRHvInstantRecoveryNetworkMappingRule"
dateModified: "2026-08-19"
---

# New-VBRHvInstantRecoveryNetworkMappingRule

## Short Description
Creates a new network mapping rule.

**Platform**: Hyper-V

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

## Syntax
```
New-VBRHvInstantRecoveryNetworkMappingRule -SourceNetwork <VBRComputerNetworkInfo>
 -TargetNetwork <VBRHvServerNetworkInfo> [<CommonParameters>]
```

## Detailed Description
This cmdlet defines the `VBRHvInstantRecoveryNetworkMappingRule` object. This object defines how to map networks in the original site to networks in the target site (site where VMs will be recovered). You can use this object to perform instant recovery of Veeam Agent computers.

## 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">SourceNetwork</span></p>
        </td>
        <td>
          <p>Specifies the array of networks connected to Veeam Agent computers.</p><p>Accepts the <code>VBRComputerNetworkInfo[]</code> object. To get this object, run the <a href="get-vbrcomputernetworkinfo.md"><code>Get-VBRComputerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRComputerNetworkInfo</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">TargetNetwork</span></p>
        </td>
        <td>
          <p>Specifies the array of virtual networks connected to the Hyper-V host which computers are restored to.</p><p>Accepts the <code>VBRHvServerNetworkInfo[]</code> object. To get this object, run the <a href="get-vbrhvservernetworkinfo.md"><code>Get-VBRHvServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrhvservernetworkinfo.md"><code>VBRHvServerNetworkInfo</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>
    </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 [`VBRHvInstantRecoveryNetworkMappingRule`](vbrhvinstantrecoverynetworkmappingrule.md) object that defines network mapping rules.

## Examples

::: example
### Configure network for an appliance

This example shows how to define settings for a new network mapping rule.

```
$network = Get-VBRComputerNetworkInfo
New-VBRHvInstantRecoveryNetworkMappingRule -SourceNetwork $network
```

Perform the following steps:

1. Run the [`Get-VBRComputerNetworkInfo`](get-vbrcomputernetworkinfo.md) cmdlet. Save the result to the `$network` variable.
2. Run the `New-VBRHvInstantRecoveryNetworkMappingRule` cmdlet. Set the `$network` variable as the `SourceNetwork` parameter value.

:::