Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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

VariableDescription
DomainControllerIP address of the domain controller machine.
UserThe sAMAccountName of the Active Directory user account.
PasswordThe new password for the user. This password must comply with the organization's Active Directory requirements.
ForceChangeMakes this password temporary by forcing the user to change it at the next login.
UnlockUnlock the account if the account is locked.

Output variables

VariableDescription
resultOne of the following outcomes:- failure - success - Policy Failure
errorMessageThe executionResult.errorMessages from the Activity designer parsing sources.
hresultPowershell command result.

Conditions

ConditionDescription
SuccessPassword was successfully reset.
Policy FailureNew password does not comply with the organization's Active Directory requirements.
FailureAn error occurred while attempting to reset the password. Additional details may be available in the workflow log.

Parent Topic:Active Directory activity pack