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

Change AD User Password activity

The Change AD User Password activity changes the password for an Active Directory user account.

This activity requires the user's current password to run, unlike the Reset AD User Password activity. If the new password violates any Active Directory password requirements, such as length or character combinations, the activity fails and returns the appropriate error message. This error message appears in the ECC queue and in hint text when a user points 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.
New_passwordThe new password to assign this user.
Old_passwordThe user's current password.

Output variables

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

Conditions

The activity provides the following conditions:

ConditionDescription
SuccessPassword successfully reset.
Policy FailurePassword does not comply with the organization's Active Directory requirements.
Incorrect old passwordPassword being changed was not entered correctly.
FailureAn error occurred while attempting to change the password. Additional details may be available in the workflow log.

Active Directory credentials with LDAP

If you are using an LDAP Server with MID Servers, note that Orchestration and Active Directory activities do not use the user name and password configured on LDAP Servers. You must create a Windows type orchestration credential record Windows credentials. The username and password in the credentials record is used for LDAP queries that Orchestration and workflow activities perform.

Parent Topic:Active Directory activity pack