---
title: "Set-VEORIRDatabase"
description: "Changes switchover settings of an instant recovery session for an Oracle database. Product: Veeam Backup & Replication Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet allows you to change the switchover option for a "
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/set-veorirdatabase.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Oracle > Set-VEORIRDatabase"
dateModified: "2026-08-20"
---

# Set-VEORIRDatabase

## Short Description
Changes switchover settings of an instant recovery session for an Oracle database.

**Product**: Veeam Backup & Replication

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

## Syntax
```
Set-VEORIRDatabase [-Database] <VEORIRDatabase> [-SwitchOverOptions <VEORIRSchedule>] [<CommonParameters>]
```

## Detailed Description
This cmdlet allows you to change the switchover option for a specified Oracle database.

::: important

You can only modify the switchover settings until the moment switchover is automatically triggered (if the `Auto` or `Scheduled` switchover options are selected).

:::

## 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">Database</span></p>
        </td>
        <td>
          <p>Specifies an Oracle database published within an instant recovery session.</p><p>Accepts the <a href="veorirdatabase.md"><code>VEORIRDatabase</code></a> object. To get this object, run the <a href="get-veorirdatabase.md"><code>Get-VEORIRDatabase</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="veorirdatabase.md"><code>VEORIRDatabase</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 (ByValue)</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>Specified a switchover option for the necessary Oracle database.</p><p>Accepts the <a href="veorirschedule.md"><code>VEORIRSchedule</code></a> object. To create this object, run the <a href="new-veorirswitchoveroptions.md"><code>New-VEORIRSwitchOverOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="veorirschedule.md"><code>VEORIRSchedule</code></a></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>
    </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 Learn.

## Examples

::: example
### Setting Scheduled Switchover of Oracle Database

This example shows how to set the scheduled switchover for the `orcl` database. The cmdlet will perform the switchover at `13:00:00` on `2026-11-24`.

```
$time = Get-Date -Date "2026-12-4 13:00:00"
$TimeUtc = $time.ToUniversalTime()
$ScheduledSwitch = New-VEORIRSwitchOverOptions -Scheduled -SwitchingTimeUtc $TimeUtc
$IRDatabase = Get-VEORIRDatabase -DatabaseName "orcl"
Set-VEORIRDatabase -Database $IRDatabase -SwitchOverOptions $ScheduledSwitch
```

Perform the following steps:

1. Run the [`Get-Date`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date) cmdlet and specify the date and time when the switchover must be performed. Save the result to the `$time` variable.
2. Use the `ToUniversalTime()` method to convert the date and time to the UTC format.
3. Run the [`New-VEORIRSwitchOverOptions`](new-veorirswitchoveroptions.md) cmdlet. Provide the `Scheduled` parameter. Set the `$TimeUtc` variable as the `SwitchingTimeUtc` parameter value. Save the result to the `$ScheduledSwitch` variable.
4. Run the [`Get-VEORIRDatabase`](get-veorirdatabase.md) cmdlet. Specify the `DatabaseName` parameter value. Save the result to the `$IRDatabase` variable.
5. Run the `Set-VEORIRDatabase` cmdlet. Specify the following options:

   - Set the `$IRDatabase` variable as the `Database` parameter value.
   - Specify the `$ScheduledSwitch` variable as the `SwitchOverOptions` parameter value.

:::

## Related Commands

- [``Get-Date``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date)
- [`New-VEORIRSwitchOverOptions`](new-veorirswitchoveroptions.md)
- [`Get-VEORIRDatabase`](get-veorirdatabase.md)