---
title: "Get-VEPSQLInstance"
description: "Returns backed-up PostgreSQL instances. Product: Veeam Backup & Replication Product Edition: Enterprise, Enterprise Plus, Veeam Universal License This cmdlet returns an array of backed-up PostgreSQL instances."
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-vepsqlinstance.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for PostgreSQL > Get-VEPSQLInstance"
dateModified: "2026-08-18"
---

# Get-VEPSQLInstance

## Short Description
Returns backed-up PostgreSQL instances.

**Product**: Veeam Backup & Replication

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

## Syntax
```
Get-VEPSQLInstance [-Session] <VEPSQLRestoreSession> [-DataDirectory <String>] [<CommonParameters>]
```

## Detailed Description
This cmdlet returns an array of backed-up PostgreSQL instances.

After you get backed-up PostgreSQL instances, you can perform the following operations with these instances:

- Run the [`Start-VEPSQLInstanceRestore`](start-vepsqlinstancerestore.md) cmdlet to restore PostgreSQL instances.
- Run the [`Start-VEPSQLInstancePublish`](start-vepsqlinstancepublish.md) cmdlet to publish PostgreSQL instances.
- Run the [`Start-VEPSQLInstanceInstantRecovery`](start-vepsqlinstanceinstantrecovery.md) cmdlet to instantly recover PostgreSQL instances.

## 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">DataDirectory</span></p>
        </td>
        <td>
          <p>Specifies a path to the data directory of the backed-up PostgreSQL instance. The cmdlet will return the PostgreSQL instance with the specified data directory.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Session</span></p>
        </td>
        <td>
          <p>Specifies an active restore session. The cmdlet will return an array of PostgreSQL instances within the specified restore session.</p><p>Accepts the <a href="vepsqlrestoresession.md"><code>VEPSQLRestoreSession</code></a> object. To get this object, run the <a href="get-vepsqlrestoresession.md"><code>Get-VEPSQLRestoreSession</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vepsqlrestoresession.md"><code>VEPSQLRestoreSession</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.

## Output Object
The cmdlet returns the [`VEPSQLInstance`](vepsqlinstance.md)`[]` array that contains backed-up PostgreSQL instances.

## Examples

::: example
### Example 1. Getting PostgreSQL Instances Within Specified Restore Session

This example shows how to get all PostgreSQL instances included in a PostgreSQL restore session.

```
$session = Get-VEPSQLRestoreSession
Get-VEPSQLInstance -Session $session[0]
```

Perform the following steps:

1. Run the [`Get-VEPSQLRestoreSession`](get-vepsqlrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session. In this example, it is the first restore session in the array.

2. Run the `Get-VEPSQLInstance` cmdlet. Set the `$session` variable as the `Session` parameter value.

:::

::: example
### Example 2. Getting PostgreSQL Instance with Specified Data Directory

This example shows how to get a specific PostgreSQL instance included in a PostgreSQL restore session.

```
$session = Get-VEPSQLRestoreSession
Get-VEPSQLInstance -Session $session[0] -DataDirectory /var/lib/pgsql/13/data
```

Perform the following steps:

1. Run the [`Get-VEPSQLRestoreSession`](get-vepsqlrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session. In this example, it is the first restore session in the array.

2. Run the `Get-VEPSQLInstance` cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `DataDirectory` parameter value.

:::

## Related Commands

[`Get-VEPSQLRestoreSession`](get-vepsqlrestoresession.md)