---
title: "New-VEORIRSwitchOverOptions"
description: "Creates a switchover option that you can use in the instant recovery session of an Oracle database. Product: Veeam Backup & Replication Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following param"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/new-veorirswitchoveroptions.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Oracle > New-VEORIRSwitchOverOptions"
dateModified: "2026-08-18"
---

# New-VEORIRSwitchOverOptions

## Short Description
Creates a switchover option that you can use in the instant recovery session of an Oracle database.

**Product**: Veeam Backup & Replication

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AutoParameterSet</code></p>

```
New-VEORIRSwitchOverOptions [-Auto] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ManualParameterSet</code></p>

```
New-VEORIRSwitchOverOptions [-Manual] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ScheduledParameterSet</code></p>

```
New-VEORIRSwitchOverOptions [-Scheduled] -SwitchingTimeUTC <DateTime> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates a switchover option that you can use in the instant recovery session of an Oracle database. You can use it to create a switchover option and define a schedule for a scheduled switchover.

## 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 <code>Auto</code> 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 manually at a later time.</p><p>To perform the switchover, use the <a href="switch-veorirdatabase.md"><code>Switch-VEORIRDatabase</code></a> cmdlet.</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 <code>Scheduled</code> mode. Switchover will be performed at the specified date and time.</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 scheduled switchover option.</p><p>Specifies the date and time in UTC when the switchover must be started.</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Docs.

## Output Object
The cmdlet returns the [`VEORIRSchedule`](veorirschedule.md) object that contains a switchover option with the defined schedule.

## Examples

::: example
### Example 1. Creating Scheduled Switchover Option

This example shows how to create a scheduled switchover option. The switchover schedule is set to `2026-11-24 13:00:00`.

```
$time = Get-Date -Date "2026-11-24 13:00:00"
$TimeUtc = $time.ToUniversalTime()
$ScheduledSwitch = New-VEORIRSwitchOverOptions -Scheduled -SwitchingTimeUtc $TimeUtc
```

Perform the following steps:

1. Run the [`Get-Date`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.6) cmdlet and specify the date and time when the switchover must be performed. Save the result to the `$time` variable.
2. Convert the scheduled time to the UTC format using the `ToUniversalTime()` method. Save the result to the `$TimeUtc` variable.
3. Run the `New-VEORIRSwitchOverOptions` cmdlet. Provide the `Scheduled` parameter. Set the `$TimeUtc` variable as the `SwitchingTimeUtc` parameter value.

:::

::: example
### Example 2. Defining Auto Switchover Option

This command defines an auto switchover option. The switchover will run immediately after database files are copied and synchronized.

```
$AutoSwitch = New-VEORIRSwitchOverOptions -Auto
```

:::

::: example
### Example 3. Defining Manual Switchover Option

This command defines a manual switchover option. The switchover will start after you initiate this process manually with the [`Switch-VEORIRDatabase`](switch-veorirdatabase.md) cmdlet.

```
$ManualSwitch = New-VEORIRSwitchOverOptions -Manual
```

:::

## Related Commands

- [`Restore-VEORIRDatabase`](restore-veorirdatabase.md)
- [`Set-VEORIRDatabase`](set-veorirdatabase.md)
- [`Switch-VEORIRDatabase`](switch-veorirdatabase.md)
- [``Get-Date``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.6)