Active Directory Provider::User Change Password

Changes user passwords. Used by Microsoft Provisioning Framework (MPF).

User Change Password is a wrapper for IADsUser::ChangePassword.

Arguments

The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes

executeData

Description:
Encapsulates the procedure's input data.

Children:
newPassword (minOccurs="1" maxOccurs="1")
oldPassword (minOccurs="1" maxOccurs="1")
path (minOccurs="1" maxOccurs="1")

newPassword

Description:
New password.

Parent:
executeData

oldPassword

Description:
Old password.

Parent:
executeData

path

Description:
Lightweight directory access protocol (LDAP) path of the user object associated with the password.

Parent:
executeData

Remarks

In the event of a failure, User Change Password rolls back to the previous password.

Schema Definition

Input

<executeData>1..1
  <path>1..1</path>
  <oldPassword>1..1</oldPassword>
  <newPassword>1..1</newPassword>
</executeData>

Sample Code

Example XML Request

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

Example XML Response

User Change Password does not return data.

Applies To

Active Directory Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Active Directory Provider::User Set Password