Get-VBRADForestRestoreSession

Short Description

Returns Microsoft Active Directory forest restore sessions.

Platform: VMware, Hyper-V

Product Edition: Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

AllParameterSets (Default)

Get-VBRADForestRestoreSession [<CommonParameters>]
Session

Get-VBRADForestRestoreSession [-Session <VBRADForestRestoreSession>] [<CommonParameters>]
Id

Get-VBRADForestRestoreSession [-Id <Guid>] [<CommonParameters>]

Detailed Description

This cmdlet returns Microsoft Active Directory forest restore sessions. You can get all active sessions, or filter by session object or session ID. Use this cmdlet to monitor or stop ongoing Microsoft Active Directory forest restore operations.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Id	Specifies the ID of the Microsoft Active Directory forest restore session. The cmdlet will return this session.	`Guid`	False	Named	True (ByPropertyName)
Session	Specifies a Microsoft Active Directory forest restore session. The cmdlet will return this session. Accepts the `VBRADForestRestoreSession` object. To get this object, run the `Get-VBRADForestRestoreSession` cmdlet.	`VBRADForestRestoreSession`	False	Named	True (ByPropertyName, ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRADForestRestoreSession object that contains properties of the Microsoft Active Directory forest restore session.

Examples

Get-VBRADForestRestoreSession Example 1. Getting All Active AD Forest Restore Sessions

This command returns all active Microsoft Active Directory forest restore sessions.

Get-VBRADForestRestoreSession

Get-VBRADForestRestoreSession Example 2. Getting AD Forest Restore Session by Session Object

This example shows how to get a specific Microsoft Active Directory forest restore session using the session object.

$sessions = Get-VBRADForestRestoreSession

Get-VBRADForestRestoreSession -Session $sessions[0]

Perform the following steps:

Run the Get-VBRADForestRestoreSession cmdlet. Save the result to the $sessions variable. The cmdlet returns an array of sessions. Note the ordinal number of the necessary session (in this example, it is the first session in the array).
Run the Get-VBRADForestRestoreSession cmdlet. Set the $sessions[0] variable as the Session parameter value.

Get-VBRADForestRestoreSession Example 3. Getting AD Forest Restore Session by ID

This command returns the Microsoft Active Directory forest restore session with the specified ID.

Get-VBRADForestRestoreSession -Id "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Start-VBRADForestRestore