---
title: "Find-VBRADEntity"
description: "Looks for Active Directory objects. Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdlet looks for Active Directory objects."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/find-vbradentity.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Protection Groups > Veeam Agent Management Protection Scope > Find-VBRADEntity"
dateModified: "2026-08-19"
---

# Find-VBRADEntity

## Short Description
Looks for Active Directory objects.

**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>AllParameterSets (Default)</code></p>

```
Find-VBRADEntity -Domain <VBRADDomain> [-Root <VBRADEntity>] [-Recurse] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Id</code></p>

```
Find-VBRADEntity -Domain <VBRADDomain> [-Id <Guid[]>] [-Root <VBRADEntity>] [-Recurse] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Name</code></p>

```
Find-VBRADEntity -Domain <VBRADDomain> [-Name <String[]>] [-Root <VBRADEntity>] [-Recurse] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Type</code></p>

```
Find-VBRADEntity -Domain <VBRADDomain> [-Type <VBRADEntityType[]>] [-Root <VBRADEntity>] [-Recurse] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet looks for Active Directory objects.

You can use this cmdlet to search for Active Directory objects you plan to add to the scope of a protection group.

## 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">Domain</span></p>
        </td>
        <td>
          <p>Specifies the Active Directory domain connection object.</p><p>Accepts the VBRADDomain object. To get this object, run the Get-VBRADDomain cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbraddomain.md"><code>VBRADDomain</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, 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 the array of object IDs. The cmdlet will return objects with these IDs.</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">Name</span></p>
        </td>
        <td>
          <p>Specifies the array of object names. The cmdlet will return objects with these names.</p><p><strong>Note</strong>: Provide the value of the Active Directory name attribute. For Computer objects, the returned <code>Name</code> property will show the dNSHostName value.</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>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">Recurse</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will look for objects from all child containers of the specified container.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Root</span></p>
        </td>
        <td>
          <p>Specifies the container of objects. The cmdlet will look for objects in this container.</p><p>If omitted, the cmdlet will look for objects in the domain container.</p><p>Accepts the VBRADEntity object. To get this object, run the Find-VBRADEntity cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbradentity.md"><code>VBRADEntity</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)</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 array of object types:</p><ul><li>Domain</li><li>Cluster</li><li>OrganizationUnit</li><li>Group</li><li>Folder</li><li>Computer</li></ul><p>The cmdlet will return objects of these types.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRADEntityType[]</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>
    </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
[`VBRADEntity`](vbradentity.md)

## Examples

::: example
### Example 1. Getting All Active Directory Objects

This example shows how to get all Active Directory objects.

```
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
Find-VBRADEntity -Domain $connection -Recurse
```

Perform the following steps:

1. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
2. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Provide the `Recurse` parameter.

:::

::: example
### Example 2. Getting Active Directory Objects by Name

This example shows how to get Active Directory objects with names containing `account`.

```
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
Find-VBRADEntity -Domain $connection -Name *account* -Recurse
```

Perform the following steps:

1. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
2. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Specify the `Name` parameter value. Provide the `Recurse` parameter.

:::

::: example
### Example 3. Getting Active Directory Objects from Container

This example shows how to get Active Directory objects from the `Accounts` container.

```
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
$root = Find-VBRADEntity -Domain $connection
$accounts = Find-VBRADEntity -Domain $connection -Root $root -Name Accounts
Find-VBRADEntity -Domain $connection -Root $accounts -Recurse
```

Perform the following steps:

1. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
2. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Save the result to the `$root` variable.
3. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Set the `$root` variable as the `Root` parameter value. Specify the `Name` parameter value. Save the result to the `$accounts` variable.
4. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Set the `$accounts` variable as the `Root` parameter value. Provide the `Recurse` parameter.

:::

::: example
### Example 4. Getting Active Directory Objects by Type

This example shows how to get all Active Directory objects of the `OrganizationUnit` type.

```
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
Find-VBRADEntity -Domain $connection -Type OrganizationUnit -Recurse
```

Perform the following steps:

1. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
2. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Set the `OrganizationUnit` option for the `Type` parameter. Provide the `Recurse` parameter.

:::

::: example
### Example 5. Getting Active Directory Objects by ID

This example shows how to get Active Directory objects by ID.

```
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
Find-VBRADEntity -Domain $connection -Id 3826d21c-0f7d-4c80-b5ef-b5568e967a6a, 85950671-5e3a-481f-8408-5af40de317c6
```

Perform the following steps:

1. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
2. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value.  Specify the `Id` parameter value.

:::

::: example
### Example 6. Getting Active Directory Object using Veeam PowerShell and Microsoft Active Directory Windows PowerShell

This example shows how to get an Active Directory object using both Veeam PowerShell and [Microsoft Active Directory Windows PowerShell](https://technet.microsoft.com/en-us/library/dd378783(WS.10).aspx) cmdlets.

```
$comp = Get-ADComputer SUPP-G3321
$compid = $comp.ObjectGUID
$connection = Get-VBRADDomain -ServerName support.east -Credentials support\jsmith
Find-VBRADEntity -Domain $connection -Id $compid
```

Perform the following steps:

1. Make sure you have the Active Directory Windows PowerShell module installed. For more information, see [Microsoft Docs](https://technet.microsoft.com/en-us/library/dd378783(WS.10).aspx#Anchor_5).
2. Run the [`Get-ADComputer`](https://learn.microsoft.com/en-us/powershell/module/activedirectory/get-adcomputer?view=windowsserver2022-ps) to get the Active Directory computer. Save the result to the `$comp` variable.
3. Use the `ObjectGUID` property of the `$comp` variable. Save the result to the `$compid` variable.
4. Run the [`Get-VBRADDomain`](get-vbraddomain.md) cmdlet. Specify the `ServerName` and `Credentials` parameter values. Save the result to the `$connection` variable.
5. Run the `Find-VBRADEntity` cmdlet. Set the `$connection` variable as the `Domain` parameter value. Set the `$compid` variable as the `Id` parameter value.

:::

## Related Commands

[`Get-VBRADDomain`](get-vbraddomain.md)