New-VESQLIRSwitchOverOptions

Short Description

Defines the switchover option that you can apply to the instant recovery session of a Microsoft SQL Server database.

Applies to

Veeam Backup & Replication

Product Edition: Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

  • Create a switchover option that starts the switchover immediately after database files are copied and synchronized.

New-VESQLIRSwitchOverOptions [-Auto] [<CommonParameters>]

  • Create a switchover option that allows you to start the switchover manually at any time after database files are copied and synchronized.

New-VESQLIRSwitchOverOptions [-Manual] [<CommonParameters>]

  • Create a switchover option that starts the switchover at a specified date and time.

New-VESQLIRSwitchOverOptions [-Scheduled] -SwitchingTimeUtc <DateTime> [<CommonParameters>]

Detailed Description

This cmdlet creates the VESQLIRSwitchOverOptions object that defines a switchover option that you can apply to the instant recovery session of Microsoft SQL Server databases. You can use this option to create a switchover option and define a schedule for a scheduled switchover.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Auto

Defines that the switchover will be performed in the Auto mode. This option starts switchover immediately after database files are copied and synchronized.

SwitchParameter

True

Named

False

Manual

Defines that the switchover will be performed manually at a later time, using the Switch-VESQLIRDatabase 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 CommonParameters section of Microsoft Docs.

Output Object

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

Examples

New-VESQLIRSwitchOverOptionsExample 1. Defining Scheduled Switchover Option

New-VESQLIRSwitchOverOptionsExample 2. Defining Automatic Switchover Option

New-VESQLIRSwitchOverOptionsExample 3. Defining Manual Switchover Option

Related Commands

Page updated 3/25/2025

Page content applies to build 12.3.1.1139