Request and response for the Add Computer Account operation

The Add Computer Account operation adds a new computer account to a group.

The following table describes the elements for the <items> XML element and adapter request for the Add Computer Account operation:

 Elements for the <items> XML element and adapter request for the Add Computer Account operation

The following figure shows a sample adapter request for the Add Computer Account operation.

Note

The Update Items process is used to add a computer account to a group. The value of the item type field is AddComputerAccount.


Adapter request for the Add Computer Account operation

<active-directory-request>
   <target>
     <host>vm-w23-rds19</host>
     <user-name>administrator</user-name>
     <password>Admin</password>
   </target>
   <commands>
     <command>
       <active-directory-command>Add Computer Account</active-directory-command>
       <object-class>Group</object-class>
       <object-distinguished-name>CN=Test-Group-1,
    DC=vm-w23-rds19,DC=local</object-distinguished-name>
       <parameters>
         <add-member>CN=mc01,CN=Computers,DC=vm-w23-rds19,DC=local</add-member>
         <add-member>CN=mc01,CN=Computers,DC=vm-w23-rds19,DC=local</add-member>
         <add-member>CN=mc02,CN=Computers,DC=vm-w23-rds19,DC=local</add-member>
         <add-member>CN=mc02,CN=Computers,DC=vm-w23-rds19,DC=local</add-member>
         <server>vm-w23-rds19</server>
         <user-name>administrator</user-name>
         <password>Admin</password>
       </parameters>
     </command>
   </commands>
 </active-directory-request>


The following figure shows a sample adapter response for the Add Computer Account operation:

Sample adapter response for the Add Computer Account 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 group  "CN=Test-Group-1,DC=vm-w23-rds19,
DC=local" -addmbr  "CN=mc02,CN=Computers,DC=vm-w23-rds19,
DC=local"  "CN=mc02,CN=Computers,DC=vm-w23-rds19,DC=local"  
"CN=mc01,CN=Computers,DC=vm-w23-rds19,
DC=local" "CN=mc01,CN=Computers,DC=vm-w23-rds19,
DC=local" -s "vm-w23-rds19" -u "administrator" -p "Admin"</command>
         <line-count>6</line-count>
         <execution-milliseconds>1985</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 group
"CN=Test-Group-1,DC=vm-w23-rds19,DC=local" -addmbr "CN=mc02,
CN=Computers,DC=vm-w23-rds19,DC=local" "CN=mc02,
CN=Computers,DC=vm-w23-rds19,DC=local" "CN=mc01,
CN=Computers,DC=vm-w23-rds19,DC=local" "CN=mc01,
CN=Computers,DC=vm-w23-rds19,DC=local" -s "vm-w23-rds19" 
-u "administrator" -p "Admin"</line>
         <line index="4">Remote application process ID: 11848</line>
         <line index="5">dsmod succeeded:CN=Test-Group-1,
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>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*