Start-VEHANARestoreSession

Short Description

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

Product: Veeam Backup & Replication

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

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.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Backup	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.	`IVEHANABackup`	True	0	True (ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

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.

Examples

Starting Restore Session

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

$backup = Get-VEHANABackup -Name "SAP HANA*"

$session = Start-VEHANARestoreSession -Backup $backup

Perform the following steps:

Run the Get-VEHANABackup cmdlet and specify the Name parameter value. Use the wildcard * character to get all backups whose names begin with “SAP HANA”. Save the result to the $backup variable.
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.