---
title: "Get-VESQLRDSDatabase"
description: "Returns backed-up Microsoft SQL Server databases running on Amazon RDS. Product: Veeam Backup & Replication Product Edition: Enterprise Plus, Veeam Universal License This cmdlet returns an array of backed-up Microsoft SQL Server databases running"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-vesqlrdsdatabase.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft SQL Server > Get-VESQLRDSDatabase"
dateModified: "2026-08-18"
---

# Get-VESQLRDSDatabase

## Short Description
Returns backed-up Microsoft SQL Server databases running on Amazon RDS.

**Product**: Veeam Backup & Replication

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

## Syntax
```
Get-VESQLRDSDatabase [-Session] <VESQLRDSRestoreSession> [-Name <String[]>] [-InstanceName <String[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet returns an array of backed-up Microsoft SQL Server databases running on Amazon RDS.

After you get the databases, you can use the following cmdlets:

- [`Get-VESQLRDSRestorePoint`](get-vesqlrdsrestorepoint.md) - to get the available restore points for a specific database.
- [`Start-VESQLRDSDatabaseRestore`](start-vesqlrdsdatabaserestore.md) - to restore your data.

## 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">InstanceName</span></p>
        </td>
        <td>
          <p>Specifies an array of names for Microsoft SQL Server instances. The cmdlet will return an array of databases located on the specified instances.</p><p>This parameter accepts wildcard characters.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies an array of names for Microsoft SQL Server databases. The cmdlet will return an array of databases with the specified names.</p><p>This parameter accepts wildcard characters.</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 databases within the specified restore session.</p><p>Accepts the <a href="vesqlrdsrestoresession.md"><code>VESQLRDSRestoreSession</code></a> object. To get this object, run the <a href="get-vesqlrdsrestoresession.md"><code>Get-VESQLRDSRestoreSession</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vesqlrdsrestoresession.md"><code>VESQLRDSRestoreSession</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 [`VESQLRDSDatabase`](vesqlrdsdatabase.md)`[]` object that contains an array of backed-up Microsoft SQL Server databases running on Amazon RDS.

## Examples

::: example
### Example 1. Getting Microsoft SQL Server Databases Within Specified Restore Session

This example shows how to get a list of all Microsoft SQL Server databases within the specified restore session.

```
$session = Get-VESQLRDSRestoreSession
$database = Get-VESQLRDSDatabase -Session $session[1]
```

Perform the following steps:

1. Run the [`Get-VESQLRDSRestoreSession`](get-vesqlrdsrestoresession.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 second restore session in the array).

2. Run the `Get-VESQLRDSDatabase` cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$database` variable to use it with other cmdlets.

:::

::: example
### Example 2. Getting Microsoft SQL Server Databases with Specified Name

This example shows how to get all Microsoft SQL Server databases with the specified name.

```
$session = Get-VESQLRDSRestoreSession
Get-VESQLRDSDatabase -Session $session[0] -Name "SQLDatabase"
```

Perform the following steps:

1. Run the [`Get-VESQLRDSRestoreSession`](get-vesqlrdsrestoresession.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-VESQLRDSDatabase` cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Specify the `Name` parameter value. Save the result to the `$database` variable to use it with other cmdlets.

:::

::: example
### Example 3. Getting Microsoft SQL Server Databases with Specific Names Belonging to Specific Instances

This example shows how to get all Microsoft SQL Server databases with specific names that belong to specific instances.

```
$session = Get-VESQLRDSRestoreSession
$databasenames = @("db1", "db2")
$instancenames = @("instance_01", "instance_02")
Get-VESQLRDSDatabase -Session $session[0] -Name $databasenames -InstanceName $instancenames
```

Perform the following steps:

1. Run the [`Get-VESQLRDSRestoreSession`](get-vesqlrdsrestoresession.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. Declare the `$databasenames` variable. Assign to this variable an array with the names of the necessary Microsoft SQL Server databases.
3. Declare the `$instancenames` variable. Assign to this variable an array with the names of the necessary Microsoft SQL Server instances.
4. Run the `Get-VESQLRDSDatabase` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `Session` parameter value and specify the necessary restore session.
   - Set the `$databasenames` variable as the `Name` parameter value.
   - Set the `$instancenames` variable as the `InstanceName` parameter value.

   Save the result to the `$database` variable to use it with other cmdlets.

:::

## Related Commands

[`Get-VESQLRDSRestoreSession`](get-vesqlrdsrestoresession.md)