---
title: "Switch-VEPSQLInstanceInstantRecovery"
description: "Performs switchover of a PostgreSQL instance published within an instant recovery session. Product: Veeam Backup & Replication Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet performs a manual switchover of a Pos"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/switch-vepsqlinstanceinstantrecovery.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for PostgreSQL > Switch-VEPSQLInstanceInstantRecovery"
dateModified: "2026-08-18"
---

# Switch-VEPSQLInstanceInstantRecovery

## Short Description
Performs switchover of a PostgreSQL instance published within an instant recovery session.

**Product**: Veeam Backup & Replication

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

## Syntax
```
Switch-VEPSQLInstanceInstantRecovery [-Instance] <VEPSQLInstanceInstantRecovery> [<CommonParameters>]
```

## Detailed Description
This cmdlet performs a manual switchover of a PostgreSQL instance published within an instant recovery session. You can perform a switchover after all database files are copied to the target server and the cache file is synchronized. Run the [`New-VEPSQLIRSwitchOverOptions`](new-vepsqlirswitchoveroptions.md) cmdlet to define the switchover option settings. For more information on the switchover options, see the [Switchover](https://helpcenter.veeam.com/docs/vbr/userguide/vep_ir_switchover.html?ver=13) section of the Veeam Explorers User Guide.

## 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">Instance</span></p>
        </td>
        <td>
          <p>Specifies a PostgreSQL instance. The cmdlet will switchover this instance.</p><p>Accepts the <a href="vepsqlinstanceinstantrecovery.md"><code>VEPSQLInstanceInstantRecovery</code></a> object. To get this object, run the <a href="get-vepsqlinstanceinstantrecovery.md"><code>Get-VEPSQLInstanceInstantRecovery</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vepsqlinstanceinstantrecovery.md"><code>VEPSQLInstanceInstantRecovery</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>
    </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.

## Examples

::: example
### Starting Switchover of Published PostgreSQL Instance

This example shows how to perform a manual switchover of the `rhel01:5433` instance.

```
$IRInstance = Get-VEPSQLInstanceInstantRecovery -InstanceName "rhel01:5433"
Switch-VEPSQLInstanceInstantRecovery -Instance $IRInstance
```

Perform the following steps:

1. Run the [`Get-VEPSQLInstanceInstantRecovery`](get-vepsqlinstanceinstantrecovery.md) cmdlet. Specify the `InstanceName` parameter value. Save the result to the `$IRInstance` variable.
2. Run the `Switch-VEPSQLInstanceInstantRecovery` cmdlet. Set the `$IRInstance` variable as the `Instance` parameter value.

:::

## Related Commands

[`Get-VEPSQLInstanceInstantRecovery`](get-vepsqlinstanceinstantrecovery.md)