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

# Get-VEADContainer

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

**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>ByDomainParameterSet</code></p>

```
Get-VEADContainer [-Domain] <VEADDomain> [[-Name] <String>] [[-Id] <Guid>] [-Recurse]
 [[-Type] <VEADContainerType>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ByParentContainerParameterSet</code></p>

```
Get-VEADContainer [-Container] <VEADContainer> [[-Name] <String>] [[-Id] <Guid>] [-Recurse] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns an array of backed-up Active Directory containers. Use this object to restore Active Directory data.

## 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 a parent container. The cmdlet will return containers that are available in this parent container.</p><p>Accepts the <a href="veadcontainer.md"><code>VEADContainer</code></a> object. To get this object, run the <code>Get-VEADContainer</code> 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 containers that are available in 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 child container. The cmdlet will return the Active Directory child container with this 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">Name</span></p>
        </td>
        <td>
          <p>Specifies a name of an Active Directory child container. The cmdlet will return the Active Directory child container with this 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 look for objects from all Active Directory child containers.</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>Named</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">Type</span></p>
        </td>
        <td>
          <p>Specifies the type of Active Directory container that you want to get. You can specify one of the following types:</p><ul><li><code>UsersAndComputers</code></li><li><code>GroupPolicyObjects</code></li><li><code>IntegratedDNS</code></li><li><code>ConfigurationPartition</code></li><li><code>DfsConfiguration</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VEADContainerType</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 [`VEADContainer`](veadcontainer.md)`[]` array that contains Active Directory containers.

## Examples

::: example
### Example 1. Getting Active Directory Containers from Domain

This example shows how to get top-level Active Directory containers that are added to a domain.

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

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value.

:::

::: example
### Example 2. Getting Active Directory Container with Specific Name from Domain

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

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
Get-VEADContainer -Domain $domain -Name "Domain controller"
```

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 3. Getting Active Directory Container with Specific ID from Domain

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

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
Get-VEADContainer -Domain $domain -ID "4e9c3f01-1955-453d-b2fe-80656d891708"
```

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Specify the `ID` parameter value.

:::

::: example
### Example 4. Getting Active Directory Containers from Parent Container

This example shows how to get all Active Directory containers from an Active Directory parent container.

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

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$parentcontainer` variable.
4. Run the `Get-VEADContainer` cmdlet. Set the `$parentcontainer` variable as the `Container` parameter value. Specify the ordinal number of the parent container.

:::

::: example
### Example 5. Getting Active Directory Containers with Specific Name from Parent Container

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

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$parentcontainer = Get-VEADContainer -Domain $domain
Get-VEADContainer -Container $parentcontainer[8] -Name "Sales Mailboxes"
```

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$parentcontainer` variable.
4. Run the `Get-VEADContainer` cmdlet. Specify the following settings:

   - Set the `$parentcontainer` variable as the `Container` parameter value. Specify the ordinal number of the parent container. 
   - Specify the `Name` parameter value.

:::

::: example
### Example 6. Getting Active Directory Container with Specific ID from Parent Container

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

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
$parentcontainer = Get-VEADContainer -Domain $domain
Get-VEADContainer -Container $parentcontainer[8] -ID "1b12ab63-4fc2-485d-a350-f5430ddde767"
```

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$parentcontainer` variable.
4. Run the `Get-VEADContainer` cmdlet. Specify the following settings:

   - Set the `$parentcontainer` variable as the `Container` parameter value. Specify the ordinal number of the parent container.
   - Specify the `Id` parameter value.

:::

::: example
### Example 7. Getting Active Directory Containers of Specific Type

This example shows how to get all Active Directory containers of the Users And Computers type.

```
$session = Get-VEADRestoreSession
$domain = Get-VEADDomain -Session $session[3]
Get-VEADContainer -Domain $domain -Type UsersAndComputers
```

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` cmdlet. Set the `$domain` variable as the `Domain` parameter value. Specify the `Type` parameter value.

:::

## Related Commands

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