---
title: "Get-VBRADForestRestoreSession"
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."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbradforestrestoresession.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Microsoft Active Directory Forest Restore > Get-VBRADForestRestoreSession"
dateModified: "2026-08-19"
---

# 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:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Get-VBRADForestRestoreSession [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Session</code></p>

```
Get-VBRADForestRestoreSession [-Session <VBRADForestRestoreSession>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Id</code></p>

```
Get-VBRADForestRestoreSession [-Id <Guid>] [<CommonParameters>]
```
  </li>
</ul>

## 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

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Id</span></p>
        </td>
        <td>
          <p>Specifies the ID of the Microsoft Active Directory forest restore session. The cmdlet will return this session.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Session</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft Active Directory forest restore session. The cmdlet will return this session.</p><p>Accepts the <a href="vbradforestrestoresession.md"><code>VBRADForestRestoreSession</code></a> object. To get this object, run the <code>Get-VBRADForestRestoreSession</code> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbradforestrestoresession.md"><code>VBRADForestRestoreSession</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the [`VBRADForestRestoreSession`](vbradforestrestoresession.md) object that contains properties of the Microsoft Active Directory forest restore session.

## Examples

::: example
### Example 1. Getting All Active AD Forest Restore Sessions

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

```
Get-VBRADForestRestoreSession
```

:::

::: example
### 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:

1. 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).
2. Run the `Get-VBRADForestRestoreSession` cmdlet. Set the `$sessions[0]` variable as the `Session` parameter value.

:::

::: example
### 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"
```

:::

## Related Commands

[`Start-VBRADForestRestore`](start-vbradforestrestore.md)