Get-VEHANABackupCatalogItem - Veeam Explorers PowerShell Reference

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Database	Specifies the database whose backup catalog items you want the cmdlet to return.	Accepts the VEHANADatabase object. To get this object, run the Get-VEHANADatabase cmdlet.	True	0	True (ByValue)
FromUTC	Specifies the point in time that defines the start of the period for which you want to see backup catalog items. Note: Make sure that the value you assign to this parameter is converted to Universal Coordinated Time (UTC).	DateTime	False	0	False
ToUTC	Specifies the point in time that defines the end of the period for which you want to see backup catalog items. Note: Make sure that the value you assign to this parameter is converted to Universal Coordinated Time (UTC).	DateTime	False	0	False
Last	Defines that the cmdlet will only return the latest item in the backup catalog.	SwitchParameter	False	Named	False
Limit	Limits the number of backup catalog items returned by the cmdlet.	Int64	False	Named	False

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:

Run the Get-VEHANARestoreSession 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 our example, it is the first restore session in the array.

Run the Get-VEHANASystem cmdlet. Set the first restore session in the $session variable as the Session parameter value.
Run the Get-VEHANADatabase 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 our example, it is the first database in the array.
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.

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:

Run the Get-VEHANARestoreSession 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 our example, it is the first restore session in the array.

Run the Get-VEHANASystem cmdlet. Set the first restore session in the $session variable as the Session parameter value.
Run the Get-VEHANADatabase 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 our example, it is the first database in the array.
Run the Get-Date 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.
Run the Get-Date cmdlet to get the current date. Convert it to UTC time. Save the result to the $fromutc variable.
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.

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:

Run the Get-VEHANARestoreSession 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 our example, it is the first restore job in the array.

Run the Get-VEHANASystem cmdlet. Set the first restore session in the $session variable as the Session parameter value.
Run the Get-VEHANADatabase 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 our example, it is the first database in the array.
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.