---
title: "Start-VBRNASInstantRecoveryMigration"
description: "This cmdlet starts migration to production for the running instant file share recovery session. It supports migration to the original or different location."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrnasinstantrecoverymigration.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > Start-VBRNASInstantRecoveryMigration"
dateModified: "2026-08-19"
---

# Start-VBRNASInstantRecoveryMigration

## Short Description
Starts migration to production for the running instant file share recovery session.

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>NasInstantRecoveryMigrationToOriginal (Default)</code></p>

```
Start-VBRNASInstantRecoveryMigration [-InstantRecovery] <VBRNASInstantRecovery> [-ReplaceAll]
 -SwitchOverOptions <VBRNASInstantRecoveryMigrationSwitchOverOptions> [-RunAsync] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>NasInstantRecoveryMigrationToDifferent</code></p>

```
Start-VBRNASInstantRecoveryMigration [-InstantRecovery] <VBRNASInstantRecovery>
 [-NASServer] <VBRUnstructuredServer> [-Path] <String> [-ReplaceAll]
 -SwitchOverOptions <VBRNASInstantRecoveryMigrationSwitchOverOptions> [-RunAsync] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet starts migration to production for the running instant file share recovery session. It supports migration to the original or different location.

## 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">InstantRecovery</span></p>
        </td>
        <td>
          <p>Specifies an instant recovery session. The cmdlet will start migration to production for this session.</p><p>Accepts the <a href="vbrnasinstantrecovery.md"><code>VBRNASInstantRecovery</code></a> object. To get this object, run the <a href="get-vbrnasinstantrecovery.md"><code>Get-VBRNASInstantRecovery</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnasinstantrecovery.md"><code>VBRNASInstantRecovery</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">NASServer</span></p>
        </td>
        <td>
          <p>Specifies a server where the mounted file share will be migrated to production.</p><p>This parameter is specified for the migration to a different location type.</p><p>Accepts the <code>VBRUnstructuredServer</code> object. To get this object, run the <a href="get-vbrunstructuredserver.md"><code>Get-VBRUnstructuredServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRUnstructuredServer</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>1</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">Path</span></p>
        </td>
        <td>
          <p>Specifies a path at the <code>NASServer</code> where the mounted file share will be migrated to production.</p><p>This parameter is specified for the migration to a different location type.</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>2</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">ReplaceAll</span></p>
        </td>
        <td>
          <p>Enables the <code>Replace All</code> option.</p><p>If you provide this parameter, the cmdlet will restore the whole file share and overwrite the existing files with the restored files.</p><p>Otherwise, the cmdlet will overwrite the existing files only if they are older than the restored files.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">RunAsync</span></p>
        </td>
        <td>
          <p>Defines  that the command returns immediately without waiting for the task to complete.</p><p><strong>Note</strong>: If the switchover is started with option <strong>Manual</strong> or <strong>Scheduled</strong>, the cmdlet will wait endlessly or for a long time. Before starting waiting, the cmdlet will display a warning.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">SwitchOverOptions</span></p>
        </td>
        <td>
          <p>Specifies switchover options for the specified instant recovery session. The cmdlet will start migration to production for the session with the specified switchover options.</p><p>Accepts the <code>VBRNASInstantRecoveryMigrationSwitchOverOptions</code> object. To create this object, run the <a href="new-vbrnasinstantrecoverymigrationswitchoveroptions.md"><code>New-VBRNASInstantRecoveryMigrationSwitchOverOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrnasinstantrecoverymigrationswitchoveroptions.md"><code>VBRNASInstantRecoveryMigrationSwitchOverOptions</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>True (ByValue)</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 [`VBRNASInstantRecoveryMigration`](vbrnasinstantrecoverymigration.md) object that defines settings of the migration to production session.

## Examples

::: example
### Example 1. Starting File Share Migration to Original Location

This command starts the file share migration to the original location.

```
$nasInstantRecovery = Get-VBRNASInstantRecovery -Id "49664A5F-9C55-4A1F-8E6A-1CD5705A684B"
$switchover = New-VBRNASInstantRecoveryMigrationSwitchOverOptions -Auto
Write-Output "Start File Share Migration."
Write-Output $nasInstantRecovery
Start-VBRNASInstantRecoveryMigration -InstantRecovery $nasInstantRecovery -SwitchOverOptions $switchover
```

Perform the following steps:

1. Run the [`Get-VBRNASInstantRecovery`](get-vbrnasinstantrecovery.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$nasInstantRecovery` variable.
2. Run the [`New-VBRNASInstantRecoveryMigrationSwitchOverOptions`](new-vbrnasinstantrecoverymigrationswitchoveroptions.md) cmdlet. Provide the `Auto` parameter. Save the result to the `$switchover` variable.
3. Run the `Write-Output` cmdlet. Specify the output wording.  
4. Run the `Write-Output` cmdlet. Provide the `$nasInstantRecovery` variable.
5. Run the `Start-VBRNASInstantRecoveryMigration` cmdlet. Set the `$nasInstantRecovery` variable as the `InstantRecovery` parameter value. Set the `$switchover` variable as the `SwitchOverOptions` parameter value.

:::

::: example
### Example 2. Starting File Share Migration to Different Location

This command starts the file share migration to a location different from the original one.

```
$nasInstantRecovery = Get-VBRNASInstantRecovery -Id "49664A5F-9C55-4A1F-8E6A-1CD5705A684B"
$nasServer = Get-VBRUnstructuredServer -Name "\\server\original_folder"
$switchover = New-VBRNASInstantRecoveryMigrationSwitchOverOptions -Auto
Write-Output "Start File Share Migration."
Write-Output $nasInstantRecovery
Start-VBRNASInstantRecoveryMigration -InstantRecovery $nasInstantRecovery -NASServer $nasServer -Path "\\server\original_folder\new_folder" -SwitchOverOptions $switchover
```

Perform the following steps:

1. Run the [`Get-VBRNASInstantRecovery`](get-vbrnasinstantrecovery.md) cmdlet. Specify the `Id` parameter value. Save the result to the `$nasInstantRecovery` variable.
2. Run the [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md) cmdlet. Specify the `Name` parameter. Save the result to the `$nasServer` variable.
3. Run the [`New-VBRNASInstantRecoveryMigrationSwitchOverOptions`](new-vbrnasinstantrecoverymigrationswitchoveroptions.md) cmdlet. Provide the `Auto` parameter. Save the result to the `$switchover` variable.
4. Run the `Write-Output` cmdlet. Specify the output wording.  
5. Run the `Write-Output` cmdlet. Provide the `$nasInstantRecovery` variable.
6. Run the `Start-VBRNASInstantRecoveryMigration` cmdlet. Specify the following settings:

   - Set the `$nasInstantRecovery` variable as the `InstantRecovery` parameter value.
   - Set the `$nasServer` variable as the `NASServer` parameter value.
   - Specify the `Path` parameter value.
   - Set the `$switchover` variable as the `SwitchOverOptions` parameter value.

:::

## Related Commands

- [`Get-VBRNASInstantRecovery`](get-vbrnasinstantrecovery.md)
- [`Get-VBRUnstructuredServer`](get-vbrunstructuredserver.md)
- [`New-VBRNASInstantRecoveryMigrationSwitchOverOptions`](new-vbrnasinstantrecoverymigrationswitchoveroptions.md)