Start-VEADRestoreSessionJob

Short Description

Starts a restore session to explore backed-up Microsoft Active Directory databases and to perform operations with these databases.

Product: Veeam Backup & Replication

Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Start-VEADRestoreSessionJob [-RestorePoint] <IVBRApplicationRestorePoint> [<CommonParameters>]

Detailed Description

This cmdlet starts a new restore session, establishes a connection to the backup server and retrieves backed-up Microsoft Active Directory databases. Within the restore session, you can get backed-up data using the following cmdlets:

After you get backed-up Microsoft Active Directory data, you can recover these databases.

Run the Start-VEADItemRestore cmdlet to restore Microsoft Active Directory objects and containers.
Run the Start-VEADItemExport cmdlet to export Microsoft Active Directory objects and containers.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
RestorePoint	Specifies a restore point to start a new restore session. You will be able to use this session to perform operations with Microsoft Active Directory databases that this restore point contains. Accepts the `IVBRApplicationRestorePoint` object. To get this object, run the `Get-VBRApplicationRestorePoint` cmdlet.	`IVBRApplicationRestorePoint`	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 Docs.

Output Object

The cmdlet returns the VEADRestoreSessionJob object that contains settings of the restore session started to explore backed-up Microsoft Active Directory data and to perform operations with this data.

Examples

Starting Restore Session

This example shows how to start a restore session to explore and perform recovery operations with backed-up Microsoft Active Directory data.

$restorepoint = Get-VBRApplicationRestorePoint -ActiveDirectory

Start-VEADRestoreSessionJob -RestorePoint $restorepoint[0]

Perform the following steps:

Run the Get-VBRApplicationRestorePoint cmdlet with the ActiveDirectory parameter. Save the result to the $restorepoint variable.

The cmdlet will return an array of restore points. Note the ordinal number of the necessary restore point. In this example, it is the first restore point in the array.
Run the Start-VEADRestoreSessionJob cmdlet. Set the $restorepoint variable as the RestorePoint parameter value and select the necessary restore point.

Get-VBRApplicationRestorePoint