---
title: "New-VBRViDiskMigrationMappingRule"
description: "This cmdlet defines mapping settings of recovered VM virtual disks and target datastores. You can run this cmdlet to specify a particular target datastore for every disk that you want to publish."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrvidiskmigrationmappingrule.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Instant Disk Recovery Migration > New-VBRViDiskMigrationMappingRule"
dateModified: "2026-08-19"
---

# New-VBRViDiskMigrationMappingRule

## Short Description
Defines mapping settings of recovered VM virtual disks and target datastores.

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

## Syntax
```
New-VBRViDiskMigrationMappingRule -TargetVirtualDevice <VBRViVirtualDevice> [-DiskType <VBRViDiskType>]
 [-Datastore <VBRViDatastoreBase>] [<CommonParameters>]
```

## Detailed Description
This cmdlet defines mapping settings of recovered VM virtual disks and target datastores. You can run this cmdlet to specify a particular target datastore for every disk that you want to publish.

## 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">Datastore</span></p>
        </td>
        <td>
          <p>Specifies a datastore or a datastore cluster. The cmdlet will map recovered VM virtual disks to the specified datastore or the datastore cluster.</p><p><strong>Note</strong>: If you do not specify this parameter, the cmdlet will will map recovered VM virtual disks to the default datastore.</p><p>Accepts the following types of objects:</p><ul><li>The <code>CViDatastoreItem</code> object. To get this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</li><li>The <code>CViDatastoreCluster</code> object. To create this object, run the <a href="find-vbrvidatastorecluster.md"><code>Find-VBRViDatastoreCluster</code></a> cmdlet.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastoreBase</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DiskType</span></p>
        </td>
        <td>
          <p>Specifies the virtual disk type settings. The cmdlet will set the virtual disks types to the specified type during the restore. You can specify one of the following disk types:</p><ul><li><code>AsSource</code></li><li><code>Thin</code></li><li><code>LazyZeroed</code></li><li><code>EagerZeroed</code></li></ul><p>Default: <code>AsSource</code></p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDiskType</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TargetVirtualDevice</span></p>
        </td>
        <td>
          <p>Specifies recovered VM virtual disks. The cmdlet will map these disks to the datastore.</p><p>Accepts the <code>VBRViVirtualDevice</code> object. To create this object, run the <a href="get-vbrvivirtualdevice.md"><code>Get-VBRViVirtualDevice</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViVirtualDevice</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>
    </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 `VBRViDiskMigrationMappingRule` object that defines mapping settings of recovered VM virtual disks with target datastores. .

## Examples

::: example
### Example 1. Mapping Recovered Virtual Disks to Default Datastore

This example shows how to map the recovered virtual disks to the default datastore. The cmdlet will map virtual disks of the VM that is backed up by the `Winsrv4515` job.

```
$backup = Get-VBRBackup -Name "Winsrv4515"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]
New-VBRViDiskMigrationMappingRule -TargetVirtualDevice $disks
```

Perform the following steps:

1. Get the backed-up VM virtual disks:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$disks` variable.

     The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array).

2. Run the `New-VBRViDiskMigrationMappingRule` cmdlet. Set the `$disks` variable as the `TargetVirtualDevice` parameter value.

:::

::: example
### Example 2. Mapping Recovered Virtual Disks to Specific Datastore

This example shows how to map the recovered virtual disks to the `LocalStore_0` datastore. This datastore is connected to the `WinSrv2073` server. The cmdlet will map virtual disks of the VM that is backed up by the `Winsrv4515` job.

```
$backup = Get-VBRBackup -Name "Winsrv4515"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]
$server = Get-VBRServer -Name "WinSrv2073"
$datastore = Find-VBRViDatastore -Server $server -Name "LocalStore_0"
New-VBRViDiskMigrationMappingRule -TargetVirtualDevice $disks -Datastore $datastore
```

Perform the following steps:

1. Get the backed-up VM virtual disks:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$disks` variable.

     The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array).

2. Get the datastore:

   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastore` variable.

3. Run the `New-VBRViDiskMigrationMappingRule` cmdlet. Set the `$disks` variable as the `TargetVirtualDevice` parameter value. Set the `$datastore` variable as the `Datastore` parameter value.

:::

::: example
### Example 3. Mapping Recovered Virtual Disks to Datastore Cluster

This example shows how to map the recovered virtual disks to the `Cluster_5` datastore cluster. This datastore cluster is connected to the `WinSrv2077` server. The cmdlet will map virtual disks of the VM that is backed up by the `Winsrv4515` job.

```
$backup = Get-VBRBackup -Name "Winsrv4515"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$disks = Get-VBRViVirtualDevice -RestorePoint $restorepoint[3]
$server = Get-VBRServer -Name "WinSrv2077"
$datastorecluster = Find-VBRViDatastoreCluster -Server $server -Name "Cluster_5"
New-VBRViDiskMigrationMappingRule -TargetVirtualDevice $disks -Datastore $datastorecluster
```

Perform the following steps:

1. Get the backed-up VM virtual disks:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$disks` variable.

     The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the fourth restore session in the array).

2. Get the datastore:

   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Find-VBRViDatastoreCluster`](find-vbrvidatastorecluster.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastorecluster` variable.

3. Run the `New-VBRViDiskMigrationMappingRule` cmdlet. Set the `$disks` variable as the `TargetVirtualDevice` parameter value. Set the `$datastorecluster` variable as the `Datastore` parameter value.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Get-VBRViVirtualDevice`](get-vbrvivirtualdevice.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)