Enable User operation

The Enable User operation enables a user account. You can use this operation also to unlock a user account. 

The following table describes the elements for the <items> XML element and adapter request for the Enable User operation:

Elements for the <items> XML element and adapter request for the Enable User operation

Element

Definition

Required

<target>

Specifies the target for the request

If this element is not present, the adapter uses the default target specified in its configuration.

No

<host>

Specifies the host name or IP address of the remote computer

To specify a dynamic target, you must use this element.

No

<user-name>

Specifies the user name for remote host authentication

To specify a dynamic target, you must use this element.

No

<password>

Specifies the password that corresponds to the user name

To specify a dynamic target, you must use this element.

No

<commands>

Indicates the beginning of the <commands> element, which contains the individual <command> elements

Yes

<command>

Indicates the beginning of a <command> element, which contains the elements that specify the operation to execute and its parameters

Yes

<active-directory-command>

Specifies the operation to execute

Default value: Enable User

Yes

<object-class>

Specifies the type of object on which to perform the operation

Default value: User

Yes

<object-distinguished-name>

Specifies the distinguished name of the object

Yes

<parameters>

Contains the element list for the operation

No

<server>

Specifies the remote server for the connection

If the object belongs to an Active Directory service hosted on a remote server, you must use this element.

Conditional

<domain>

Specifies the remote domain for the connection

If the object belongs to an Active Directory service hosted on a remote server, you must use this element.

Conditional

<user-name>

Specifies the logon user name for the remote server

Conditional

<password>

Specifies the password associated with the user name

Conditional

 

The following figure shows a sample adapter request for the Enable User operation:

Adapter request for the Enable User operation

<active-directory-request>
    <target>
      <host>vm-w23-rds19</host>
      <user-name>administrator</user-name>
      <password>bmcAdm1n</password>
    </target>
    <commands>
      <command>
        <active-directory-command>Enable User</active-directory-command>
        <object-class>User</object-class>
        <object-distinguished-name>CN=rohitn-pun-01,CN=Users,
      DC=vm-w23-rds19,DC=local</object-distinguished-name>
        <parameters>
          <server>vm-w23-rds19</server>
          <user-name>administrator</user-name>
          <password>bmcAdm1n</password>
        </parameters>
      </command>
    </commands>
  </active-directory-request>



The following figure shows a sample adapter response for the Enable User operation:

Sample adapter response for the Enable User operation

<active-directory-response>
  <metadata>
    <status>success</status>
  </metadata>
  <target-output host="vm-w23-rds19">
    <metadata>
      <os-id>Windows 2003</os-id>
      <os-version>5.2 Build 3790 Service Pack 2</os-version>
      <status>success</status>
    </metadata>
    <commands-output>
      <command-output>
        <metadata>
          <command>dsmod user  "CN=rohitn-pun-01,CN=Users,
    DC=vm-w23-rds19,DC=local" -disabled no -s "vm-w23-rds19" 
    -u "administrator" -p "bmcAdm1n"</command>
          <line-count>6</line-count>
          <execution-milliseconds>922</execution-milliseconds>
          <exit-code>0</exit-code>
          <status>success</status>
        </metadata>
        <output>
          <line index="1">Attempting to connect to remote host...</line>
          <line index="2">Initialising rctrlx server component...</line>
          <line index="3">Executing remote application: cmd /c dsmod user 
    "CN=rohitn-pun-01,CN=Users,DC=vm-w23-rds19,DC=local" -disabled no -s 
    "vm-w23-rds19" -u "administrator" -p "bmcAdm1n"</line>
          <line index="4">Remote application process ID: 2792</line>
          <line index="5">dsmod succeeded:CN=rohitn-pun-01,CN=Users,
    DC=vm-w23-rds19,DC=local</line>
          <line index="6">Remote application exited with code: 0</line>
        </output>
      </command-output>
    </commands-output>
  </target-output>
</active-directory-response>
Was this page helpful? Yes No Submitting... Thank you

Comments