# Get Objects by Filter

> `UiPath.ActiveDirectoryDomainServices.Activities.GetObjectsByFilter`

`UiPath.ActiveDirectoryDomainServices.Activities.GetObjectsByFilter`

## Description

Retrieves the list of **Active Directory** objects based on an input filter.

## Project compatibility

Windows - Legacy | Windows

## Configuration

### Common

* **DisplayName** - The display name of the activity.

### Input

* **Location** - Specifies the **Distinguished Name** needed for identifying the Active Directory location from where to retrieve the objects.
* **ObjectCategory** - Establishes the category of objects to be retrieved (eg. "person").
* **ObjectClass** - Establishes the class of objects to be retrieved (eg. "group", "user", "computer", "organizationalUnit").
* **PropertyToFilterBy** - Specifies the object property to search by (eg. "sAMAccountName", "Name").
* **PropertyValue** - Specifies the value of the specified property.
* **Relation** - Specifies the operator to be used in the filter expression. The default value is `EqualTo`.
* **Connection** - Establish the connection that needs to be used. There are two available options, **Primary** and **Secondary**. The default option is **Primary**.

### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Output

* **Objects** - Provides a list containing the Distinguished Names of the objects matching the filter criteria.