---
title: "Get-VEADItem"
description: "Returns backed-up Active Directory objects. Product: Veeam Backup & Replication Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet returns back"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-veaditem.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft Active Directory > Get-VEADItem"
dateModified: "2026-08-18"
---

# Get-VEADItem

## Short Description
Returns backed-up Active Directory objects.

**Product**: Veeam Backup & Replication

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

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>ByContainerParameterSet</code></p>

```
Get-VEADItem [[-Name] <String>] [-Container] <VEADContainer> [-Recurse] [[-Id] <Guid>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ByContainerLdapQueryParameterSet</code></p>

```
Get-VEADItem [-Container] <VEADContainer> [-LDAPQuery] <String> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ByDomainLdapQueryParameterSet</code></p>

```
Get-VEADItem [-Domain] <VEADDomain> [-LDAPQuery] <String> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns backed-up Active Directory objects.

## 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">Container</span></p>
        </td>
        <td>
          <p>Specifies an Active Directory container. The cmdlet will return an array of objects added to this container.</p><p>Accepts the <a href="veadcontainer.md"><code>VEADContainer</code></a> object. To get this object, run the <a href="get-veadcontainer.md"><code>Get-VEADContainer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="veadcontainer.md"><code>VEADContainer</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Domain</span></p>
        </td>
        <td>
          <p>Specifies an Active Directory domain. The cmdlet will return an array of objects added to this domain.</p><p>Accepts the <a href="veaddomain.md"><code>VEADDomain</code></a> object. To get this object, run the <a href="get-veaddomain.md"><code>Get-VEADDomain</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="veaddomain.md"><code>VEADDomain</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Id</span></p>
        </td>
        <td>
          <p>Specifies an ID of an Active Directory object. The cmdlet will return Active Directory objects with the specified ID.</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>1</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LDAPQuery</span></p>
        </td>
        <td>
          <p>Specifies an LDAP search query. The cmdlet will return Active Directory objects according to this query.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>1</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of an Active Directory object. The cmdlet will return objects with the specified name.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>2</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Recurse</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return Active Directory objects with their child objects. For example, the <em>Computer</em> object can contain <em>Shared Folder</em> and <em>Printer</em> objects.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>3</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Docs.

## Output Object
The cmdlet returns the [`VEADItem`](veaditem.md)`[]` array that contains Active Directory items.

## Examples

::: example
### Example 1. Getting All Active Directory Objects from Specific Container

This example shows how to get all Active Directory objects from a specific parent container.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$parentcontainer = Get-VEADContainer -Domain $domain
Get-VEADItem -Container $parentcontainer[3]
```

Perform the following steps:

1. Run the [`Get-VEADRestoreSession`](get-veadrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in this example, it is the fourth restore session in the array).

2. Run the [`Get-VEADDomain`](get-veaddomain.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$domain` variable.
3. Run the [`Get-VEADContainer`](get-veadcontainer.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$parentcontainer` variable.
4. Run the `Get-VEADItem` cmdlet. Set the `$parentcontainer` variable as the `Container` parameter value. Specify the ordinal number of the parent container.

:::

::: example
### Example 2. Getting Active Directory Object with Specific ID from Specific Container

This example shows how to get an Active Directory object with a specific ID from a specific Active Directory container.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$container = Get-VEADContainer -Domain $domain
Get-VEADItem -Container $container -Id "2687bd4b-1028-47e7-b720-6bf065179452"
```

Perform the following steps:

1. Run the [`Get-VEADRestoreSession`](get-veadrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in this example, it is the fourth restore session in the array).

2. Run the [`Get-VEADDomain`](get-veaddomain.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$domain` variable.
3. Run the [`Get-VEADContainer`](get-veadcontainer.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$container` variable.
4. Run the `Get-VEADItem` cmdlet. Set the `$container` variable as the `Container` parameter value. Specify the `Id` parameter value.

:::

::: example
### Example 3. Getting All Active Directory Objects with Specific Name from Specific Child Container

This example shows how to get all Active Directory objects with a specific name from an Active Directory child container.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$parentcontainer = Get-VEADContainer -Domain $domain -Id 0486045e-b583-4559-a0ab-d78b99f1b95d
$childcontainer = Get-VEADContainer -Container $parentcontainer
Get-VEADItem -Container $childcontainer -Name "SalesMailbox"
```

Perform the following steps:

1. Run the [`Get-VEADRestoreSession`](get-veadrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in this example, it is the fourth restore session in the array).

2. Run the [`Get-VEADDomain`](get-veaddomain.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$domain` variable.
3. Run the [`Get-VEADContainer`](get-veadcontainer.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Specify the `Id` parameter value. Save the result to the `$parentcontainer` variable.
4. Run the [`Get-VEADContainer`](get-veadcontainer.md) cmdlet. Set the `$parentcontainer` variable as the `Container` parameter value. Save the result to the `$childcontainer` variable.
5. Run the `Get-VEADItem` cmdlet. Set the `$childcontainer` variable as the `Container` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 4. Getting Active Directory Objects from Specific Container with LDAP Query

This example shows how to use an LDAP query to get an Active Directory object from a specific Active Directory container.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$container = Get-VEADContainer -Domain $domain
Get-VEADItem -Container $container -LDAPQuery "(cn=SalesMailboxe8e8782f639e4a24898b93c325d8ed9d)"
```

Perform the following steps:

1. Run the [`Get-VEADRestoreSession`](get-veadrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in this example, it is the fourth restore session in the array).

2. Run the [`Get-VEADDomain`](get-veaddomain.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$domain` variable.
3. Run the [`Get-VEADContainer`](get-veadcontainer.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$container` variable.
4. Run the `Get-VEADItem` cmdlet. Set the `$container` variable as the `Container` parameter value. Specify the `LDAPQuery` parameter value.

:::

::: example
### Example 5. Getting Active Directory Objects from Specific Domain with LDAP Query

This example shows how to use an LDAP query to get an Active Directory object from a specific domain.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
Get-VEADItem -Domain $domain -LDAPQuery "(cn=ISW12R2SP13)"
```

Perform the following steps:

1. Run the [`Get-VEADRestoreSession`](get-veadrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in this example, it is the fourth restore session in the array).

2. Run the [`Get-VEADDomain`](get-veaddomain.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Save the result to the `$domain` variable.
3. Run the `Get-VEADItem` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Specify the `LDAPQuery` parameter value.

:::

## Related Commands

- [`Get-VEADRestoreSession`](get-veadrestoresession.md)
- [`Get-VEADDomain`](get-veaddomain.md)
- [`Get-VEADContainer`](get-veadcontainer.md)