---
title: "Get-VEHANABackupCatalogItem"
description: "Returns backup catalog items for a specific SAP HANA database. Product: Veeam Backup & Replication Product Edition: Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet returns an array of backup"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-vehanabackupcatalogitem.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for SAP HANA > Get-VEHANABackupCatalogItem"
dateModified: "2026-08-18"
---

# Get-VEHANABackupCatalogItem

## Short Description
Returns backup catalog items for a specific SAP HANA database.

**Product**: Veeam Backup & Replication

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>TimeSpanParameterSet</code></p>

```
Get-VEHANABackupCatalogItem [-Database] <VEHANADatabase> [[-FromUTC] <DateTime>] [[-ToUTC] <DateTime>]
 [-Limit <Int64>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>LastBackupParameterSet</code></p>

```
Get-VEHANABackupCatalogItem [-Database] <VEHANADatabase> [-Last] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns an array of backups of a specific SAP HANA database that are created by Veeam Plug-in for SAP HANA.

## 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">Database</span></p>
        </td>
        <td>
          <p>Specifies the database whose backup catalog items you want the cmdlet to return.</p><p>Accepts the <a href="vehanadatabase.md"><code>VEHANADatabase</code></a> object. To get this object, run the <a href="get-vehanadatabase.md"><code>Get-VEHANADatabase</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vehanadatabase.md"><code>VEHANADatabase</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>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">FromUTC</span></p>
        </td>
        <td>
          <p>Specifies the point in time that defines the start of the period for which you want to see backup catalog items.</p><p><strong>Note</strong>: Make sure that the value you assign to this parameter is converted to Universal Coordinated Time (UTC).</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>0</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">Last</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will only return the latest item in the backup catalog.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">Limit</span></p>
        </td>
        <td>
          <p>Limits the number of backup catalog items returned by the cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int64</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">ToUTC</span></p>
        </td>
        <td>
          <p>Specifies the point in time that defines the end of the period for which you want to see backup catalog items.</p><p><strong>Note</strong>: Make sure that the value you assign to this parameter is converted to Universal Coordinated Time (UTC).</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>False</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 [`VEHANABackupCatalogItem`](vehanabackupcatalogitem.md)`[]` array that contains backups of the selected database.

## Examples

::: example
### Example 1. Getting All Backups of Specific SAP HANA Database

This example returns all backups of a specific SAP HANA database.

```
$session = Get-VEHANARestoreSession
$system = Get-VEHANASystem -Session $session[0]
$database = (Get-VEHANADatabase -System $system)[0]
$backup = Get-VEHANABackupCatalogItem -Database $database
```

Perform the following steps:

1. Run the [`Get-VEHANARestoreSession`](get-vehanarestoresession.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-VEHANASystem`](get-vehanasystem.md) cmdlet. Set the first restore session in the `$session` variable as the `Session` parameter value.
3. Run the [`Get-VEHANADatabase`](get-vehanadatabase.md) cmdlet and set the `$system` variable as the `System` parameter value. Select the necessary database returned by this command and save it to the `$database` variable. In this example, it is the first database in the array.
4. Run the `Get-VEHANABackupCatalogItem` cmdlet and set the `$database` variable as the `Database` parameter value. Save the result to the `$backup` variable to be able to use it with other cmdlets.

:::

::: example
### Example 2. Getting SAP HANA Database Backups Created in Specified Time Frame

This command returns all backups of an SAP HANA database made within the last 30 days.

```
$session = Get-VEHANARestoreSession
$system = Get-VEHANASystem -Session $session[0]
$database = (Get-VEHANADatabase -System $system)[0]
$fromutc = ((Get-Date).AddDays(-30)).ToUniversalTime()
$toutc = (Get-Date).ToUniversalTime()
Get-VEHANABackupCatalogItem -Database $database -FromUTC $fromutc -ToUTC $toutc -Limit 5
```

Perform the following steps:

1. Run the [`Get-VEHANARestoreSession`](get-vehanarestoresession.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-VEHANASystem`](get-vehanasystem.md) cmdlet. Set the first restore session in the `$session` variable as the `Session` parameter value.
3. Run the [`Get-VEHANADatabase`](get-vehanadatabase.md) cmdlet and set the `$system` variable as the `System` parameter value. Select the necessary database returned by this command and save it to the `$database` variable. In this example, it is the first database in the array.
4. Run the [`Get-Date`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.6) cmdlet to get the current date. Subtract 30 days from this date and convert it to UTC time. Save the result to the `$fromutc` variable.
5. Run the [`Get-Date`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.6) cmdlet to get the current date. Convert it to UTC time. Save the result to the `$fromutc` variable.
6. Run the `Get-VEHANABackupCatalogItem` cmdlet and set the `$database` variable as the `Database` parameter value. Set the `$fromutc` variable as the `FromUTC` parameter value and set the `$toutc` variable as the `ToUTC` parameter value. Use the `Limit` parameter to specify the number of backups returned by the cmdlet.

:::

::: example
### Example 3. Getting the Latest Backup of Specific SAP HANA Database

This command returns the latest available backup in the backup catalog of the specified database.

```
$session = Get-VEHANARestoreSession
$system = Get-VEHANASystem -Session $session
$database = (Get-VEHANADatabase -System $system)[0]
$backup = Get-VEHANABackupCatalogItem -Database $database -Last
```

Perform the following steps:

1. Run the [`Get-VEHANARestoreSession`](get-vehanarestoresession.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 job. In this example, it is the first restore job in the array.

2. Run the [`Get-VEHANASystem`](get-vehanasystem.md) cmdlet. Set the first restore session in the `$session` variable as the `Session` parameter value.
3. Run the [`Get-VEHANADatabase`](get-vehanadatabase.md) cmdlet and set the `$system` variable as the `System` parameter value. Select the necessary database returned by this command and save it to the `$database` variable. In this example, it is the first database in the array.
4. Run the `Get-VEHANABackupCatalogItem` cmdlet, set the `$database` variable as the `Database` parameter value, and provide the `Last` parameter. Save the result to the `$backup` variable to be able to use it with other cmdlets.

:::

## Related Commands

- [`Get-VEHANARestoreSession`](get-vehanarestoresession.md)
- [`Get-VEHANASystem`](get-vehanasystem.md)
- [`Get-VEHANADatabase`](get-vehanadatabase.md)
- [``Get-Date``](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.6)