---
title: "New-VBRNASInstantRecoveryMigrationSwitchOverOptions"
description: "This cmdlet defines the switchover parameter that can be used when starting the file share migration session or for changing settings of an already running file share migration session."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrnasinstantrecoverymigrationswitchoveroptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Unstructured Data Backup > Unstructured Data Recovery > New-VBRNASInstantRecoveryMigrationSwitchOverOptions"
dateModified: "2026-08-19"
---

# New-VBRNASInstantRecoveryMigrationSwitchOverOptions

## Short Description
Defines the switchover parameter that can be used when starting the file share migration session or for changing settings of an already running file share migration 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>SwitchOverAutomatic</code></p>

```
New-VBRNASInstantRecoveryMigrationSwitchOverOptions [-Auto] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SwitchOverManual</code></p>

```
New-VBRNASInstantRecoveryMigrationSwitchOverOptions [-Manual] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SwitchOverScheduled</code></p>

```
New-VBRNASInstantRecoveryMigrationSwitchOverOptions [-Scheduled] -SwitchingTimeUtc <DateTime> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet defines the switchover parameter that can be used when starting the file share migration session or for changing settings of an already running file share migration session. You can use this cmdlet to define settings for performing a switchover in the automatic, manual or scheduled mode.

## 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">Auto</span></p>
        </td>
        <td>
          <p>Defines that the switchover will be performed in the <strong>Automatic</strong> mode.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">Manual</span></p>
        </td>
        <td>
          <p>Defines that the switchover will be performed in the <strong>Manual</strong> mode.</p><p>Use the <a href="switch-vbrnasinstantrecoverymigration.md"><code>Switch-VBRNASInstantRecoveryMigration</code></a> cmdlet to start the switchover in the Manual mode.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">Scheduled</span></p>
        </td>
        <td>
          <p>Defines that the switchover will be performed in the <strong>Scheduled</strong> mode.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">SwitchingTimeUtc</span></p>
        </td>
        <td>
          <p>For the <strong>Scheduled</strong> switchover option, specifies data and time when the switchover will take place.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</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 [`VBRNASInstantRecoveryMigrationSwitchOverOptions`](vbrnasinstantrecoverymigrationswitchoveroptions.md) object that defines settings of the migration to production session.

## Examples

::: example
### Example 1. Creating Automatic Switchover Options for Migration of Instant Restore for File Backups

This command defines settings for performing a switchover in the automatic mode.

```
$switchover = New-VBRNASInstantRecoveryMigrationSwitchOverOptions -Auto
Write-Output "Create automatic options for migration of instant restore for file backups."
Write-Output $switchover
```

:::

::: example
### Example 2. Creating Manual Switchover Options for Migration of Instant Restore for File Backups

This command defines settings for performing a switchover in the manual mode.

```
$switchover = New-VBRNASInstantRecoveryMigrationSwitchOverOptions -Manual
Write-Output "Create manual options for migration of instant restore for file backups."
Write-Output $switchover
```

:::

::: example
### Example 3. Creating Scheduled Switchover Options for Migration of Instant Restore for File Backups

This command defines settings for performing a switchover in the scheduled mode.

```
$switchover = New-VBRNASInstantRecoveryMigrationSwitchOverOptions -Scheduled -SwitchingTimeUtc "2020-11-24 13:00:00"
Write-Output "Create scheduled options for migration of instant restore for file backups."
Write-Output $switchover
```

:::

## Related Commands

[`Switch-VBRNASInstantRecoveryMigration`](switch-vbrnasinstantrecoverymigration.md)