Active Directory User Add Groups

Last updated
Save as PDF

Overview
Downloads
Detailed Description
Parameters
Sample Configuration
Results
Change Log

Overview

Finds a user in active directory by Distinguished Name, Full Name, Email Address, or User Logon and adds the user as a member to one or more groups. This handler will raise an Exception if the specified User or any of the specified Groups are not found in the Active Directory system.

Downloads

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

active_directory_user_add_groups_v2.zip

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 user based on the search parameters provided. If a matching user is found, it will be added as a member to each group specified in the groups parameter will be added to the user.

* If 'Distinguished Name' is selected, the 'distinguishedName' attribute will be used directly to retrieve the User entry.

* If 'Full Name' is selected, the 'cn' attribute will be used to retrieve the User entry.

* If 'User Name' is selected, the 'userprincipalname' value will be used if the "Search Value" parameter includes an '@' sign (IE john.doe@domain.com) and the 'samaccountname' will be used if it does not (IE john.doe).

* If 'Email Address' is selected, the 'mail' attribute will be used to retrieve the User entry.

This handler will raise an Exception if the specified User or any of the specified Groups are not found in the Active Directory system.

Parameters

Name	Description
Search By	'Distinguished Name', 'Full Name', 'User Name', or 'Email Address'
Search Value	The value of the Distinguished Name, Full Name, User Logon, or Email Address that will be used to search for the desired user.
Groups	The common name(s) of the group(s) to add. More than one group can be specified by separating each group with a comma.

Sample Configuration

Parameter	Example Configuration
Search By::	User Name
Search Value::	<%=@answers['ReqFor Login ID']%>
Groups::	<%=@answers['Groups']%>

Results

There are no resutls

Change Log

Version	Date	Description
V1	2011-01-13	Initial version
V2	2014-08-05	Changed the password info value to be encrypted.