Reset AD User Password activity

The Reset AD User Password activity resets the password of a user account in Windows Active Directory.

If the new password violates any Active Directory password requirements, such as length or character combinations, the reset activity fails and returns the appropriate error message. This error appears in the ECC Queue and when you point to the activity in the workflow editor.

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. Reset AD User Password input variables
Variable Description
DomainController IP address of the domain controller machine.
User The sAMAccountName of the Active Directory user account.
Password The new password for the user. This password must comply with the organization's Active Directory requirements.
ForceChange Makes this password temporary by forcing the user to change it at the next login.
Unlock Unlock the account if the account is locked.

Output variables

Table 2. Reset AD User Password output variables
Variable Description
result One of the following outcomes:
  • failure
  • success
  • Policy Failure
errorMessage The executionResult.errorMessages from the Activity designer parsing sources.
hresult Powershell command result.

Conditions

Table 3. Reset AD User Password conditions
Condition Description
Success Password was successfully reset.
Policy Failure New password does not comply with the organization's Active Directory requirements.
Failure An error occurred while attempting to reset the password. Additional details may be available in the workflow log.