Skip to main content

IMPORTANT - Product End of Life Statement - IMPORTANT

Request RE, Survey, and Calendar 1.5 Support Ending December 31, 2020
Contact Kinetic Data Support with Questions
Kinetic Community

Active Directory Distribution List Member Retrieve

Finds a Distribution List in active directory by Distinguished Name, or Email Address and returns a comma delimited list of immediate members (e-mail addresses)


By downloading this file, you acknowledge that you agree to our Terms of Service

Detailed Description

This handler will use the server information and user credentials configured in the task info values to authenticate and connect to the specified Active Directory server (using LDAP) and search for the distribution group on the search parameters provided. If Email Address is the 'search by' parameter, the handler looks for a '@' symbol in the User Logon to determine how to search for the User Logon name. A '@' symbol indicates a search for the LDAP attribute userPrincipalName (up to 100 characters) while the absence of the '@' symbol will result in a search for the LDAP attribute sAMAccountName (pre-Windows 2000).

  • If 'Distinguished Name' is selected, the 'distinguishedName' attribute will be used directly to retrieve the User objects that are a member of the provided group.

  • If 'Email Address' is selected, the Distinguished Name of the group will first be searched for by the mail address.


Name Description
Search By Choose which attribute of the user to search by
Search Value The actual search expression to search for

Sample Configuration

Parameter Example Configuration
Search By Email Address
Search Value


Name Description
Email Addresses The email addresses of all users in the group.

Change Log

Version Date Description
1 2014-03-17 * Initial version. See README for details.