The Create AD Object activity creates an object in Windows Active Directory.

This activity fails if it finds an existing object with matching input variables.

To access this activity in the Workflow Editor, select the Custom tab, and then navigate to Custom Activities > Active Directory.
Note: This activity replaces an AD activity by the same name available in prior releases. If you have a workflow that uses the deprecated activity, your workflow will continue to work normally after upgrading to Instanbul. However, all new workflows must use the custom version of this activity, which was built with the PowerShell activity designer.

Input variables

Table 1. Create AD Object input variables
Variable Description
DomainController IP address of the domain controller machine.
Type The object type to create: user, group, or computer.
OU The organizational unit to which this object belongs.
ObjectName The sAMAccountName of the Active Directory object. Object name is also used for the name attribute in Active Directory. This behavior is available in ActiveDirectory.psm1. Whatever is passed as the Object name becomes both the samAccountName and the name of the new user in Active Directory.
ObjectData A JSON object containing Active Directory property names and their corresponding values. For example:
{ 
  "givenName" : "John",
  "SN" : "Doe",
  "title" : "Sr. Account Specialist",
  "allowLogin" : true
}
This example sets the first name (givenName), last name (SN), and title on the Active Directory user account and allows that user to log in (allowLogin). This field allows expression evaluation via the ${} variable substitution syntax.

Output variables

Table 2. Create AD Object output variables
Variable Description
result Either success or failure.
errorMessage The executionResult.errorMessages from the Activity designer parsing sources.

Conditions

Table 3. Create AD Object conditions
Condition Description
Success A Windows Active Directory object was created successfully.
Failure An error occurred while attempting to create the AD object. Additional details may be available in the workflow log.