Short Description

Starts a restore session to explore backed-up SAP HANA databases and to perform operations with these databases.

Applies to

Veeam Backup & Replication

Product Edition: Enterprise Plus, Veeam Universal License


Start-VEHANARestoreSession [-Backup] <IVEHANABackup> [<CommonParameters>]

Detailed Description

This cmdlet starts a new restore session, establishes a connection to the backup server and retrieves backed-up SAP HANA databases. Within the restore session, you can get the backed-up SAP HANA system using the Get-VEHANASystem cmdlet, and then you can get any database on the system with the Get-VEHANADatabase cmdlet.

Note the difference between a restore session and a restore job. A restore session is a preliminary step where Veeam Explorer for SAP HANA has retrieved the backup from the backup repository, pending restore operations. A restore job is the process of restoring data from the backup to the target SAP HANA system.







Accept Pipeline Input


Specifies a backup used to start a new restore session. You will be able to use the session to perform restore operations with the SAP HANA databases in the backup.

Accepts the IVEHANABackup object. To get this object, run the Get-VEHANABackup cmdlet.



True (ByValue)


This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VEHANARestoreSession object that contains settings of the restore session started to explore backed-up SAP HANA databases and to perform restore operations with these databases.


Starting Restore Session

This example shows how to start a restore session to perform operations with SAP HANA databases.

$backup = Get-VEHANABackup -Name "Backup_1"

$session = Start-VEHANARestoreSession -Backup $backup

Perform the following steps:

  1. Run the Get-VEHANABackup cmdlet and specify the Name parameter value. Save the result to the $backup variable.
  2. Run the Start-VEHANARestoreSession cmdlet. Set the $backup variable as the Backup parameter value. Save the result to the $session variable to be able to use it with other cmdlets.

Related Commands

Page updated 3/8/2024

Page content applies to build