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:

AutoParameterSet

New-VEORIRSwitchOverOptions [-Auto] [<CommonParameters>]
ManualParameterSet

New-VEORIRSwitchOverOptions [-Manual] [<CommonParameters>]
ScheduledParameterSet

New-VEORIRSwitchOverOptions [-Scheduled] -SwitchingTimeUTC <DateTime> [<CommonParameters>]

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

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Auto	Defines that the switchover will be performed in the `Auto` mode.	`SwitchParameter`	True	Named	False
Manual	Defines that the switchover will be performed manually at a later time. To perform the switchover, use the `Switch-VEORIRDatabase` cmdlet.	`SwitchParameter`	True	Named	False
Scheduled	Defines that the switchover will be performed in the `Scheduled` mode. Switchover will be performed at the specified date and time.	`SwitchParameter`	True	Named	False
SwitchingTimeUTC	For the scheduled switchover option. Specifies the date and time in UTC when the switchover must be started.	`DateTime`	True	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Docs.

Output Object

The cmdlet returns the VEORIRSchedule object that contains a switchover option with the defined schedule.

Examples

New-VEORIRSwitchOverOptions 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:

Run the Get-Date cmdlet and specify the date and time when the switchover must be performed. Save the result to the $time variable.
Convert the scheduled time to the UTC format using the ToUniversalTime() method. Save the result to the $TimeUtc variable.
Run the New-VEORIRSwitchOverOptions cmdlet. Provide the Scheduled parameter. Set the $TimeUtc variable as the SwitchingTimeUtc parameter value.

New-VEORIRSwitchOverOptions 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

New-VEORIRSwitchOverOptions 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 cmdlet.

$ManualSwitch = New-VEORIRSwitchOverOptions -Manual