AD: Advanced Search

Description

Use the step to provide the list of all Active Directory Users or Groups for the specified Object Type using the specified Path and Property search criteria.

Configurations

Field name	Description
Step name	Specify a unique name for the step.
CONNECTION tab:	Connection fields
Server Name	Specify the Hostname or Server Name or Fully Qualified Domain Name or IP address of machine where Active Directory is hosted. The field is mandatory.
Port	Specify the port number for Active Directory. If port number is not provided, use the internal default port for Active Directory, that is, 389. The port should be an integer.
Username	Specify the user's logon name. For example, sbrown, scott.brown, and so on. Or Specify the user's principal name. For example, sbrown@autoedge.com of an Active Directory account to authenticate. The field is mandatory.
Password	Specify the password for the username. You can specify static values or variables. The data type is string and the field is mandatory.
Test Connection	Click to verify if the connection is available or not. For verification purpose, the fields coming from previous steps are not allowed since field values can only be accessed when workflow is in Running state. Static values and environment variables are allowed.
INPUT tab:	Input Fields
Object Type	Specify one object type from the following: User Or Group. The data type is string and the field is mandatory.
Path	Specify the path of an Active Directory object for advanced search. The Active Directory object can be, Distinguished name (DN), for example, OU=Temp, DC=autoedge, DC=com or Canonical name, for example, automationedge.com/Temp. The data type is string and the field is mandatory.
Tabular fields	Note: At least one property name, search condition, and respective property value must be selected in the table fields.
Property Name	Click to select name of the property from the dialog. The data type is string and the field is mandatory.
Search Condition	Select the search condition from the list. The available values are: * Starts with * Ends with * Is (exactly) * Is not * Present * Not present The data type is string and the field is mandatory.
Property Value	Specify a property value. The data type is string and is mandatory.
OUTPUT tab:	Output Field
Name	Specify an output field to hold the result- Name upon successful plugin execution. The default label for the field is Name. The field is mandatory.
Distinguished Name	Specify an output field to hold the result: Distinguished Name on the successful plugin execution. The default labele for the field is DistinguishedName. The field is mandatory. Note: Advance Search returns Name and Distinguished Name as output. In case you need to use the output of Advanced Search but additionally need User Logon Name then you need to use Get User Properties step after Advanced Search in the workflow to get the User Principal Name by providing DN as input. For example, Suppose you want to know Does User Exist / Is Account Locked for all the users returned in Advanced Search, you need User Principal Name to input DoesUserExist / IsAccountLocked steps. Get User Properties step after Principal Name can fetch the User Principal Name.