Create Universal Distribution Group operation

The Create Universal Distribution Group operation creates a new universal distribution group.

The following table describes the elements for the <items> XML element and adapter request for the Create Universal Distribution Group operation:

 Elements for the <items> XML element and adapter request for the Create Universal Distribution Group operation

The following figure shows a sample adapter request for the Create Universal Distribution Group operation:

Adapter request for the Create Universal Distribution Group operation

<active-directory-request>
   <target>
     <host>vm-w23-rds19</host>
     <user-name>administrator</user-name>
     <password>bmcAdm1n</password>
   </target>
   <commands>
     <command>
       <active-directory-command>Create</active-directory-command>
       <object-class>Universal Distribution Group</object-class>
       <object-distinguished-name>CN=universal-distribution-group,
    DC=vm-w23-rds19,DC=local</object-distinguished-name>
       <parameters>
         <sam-account-name>UNIVERSAL-DISTRIBUTION-01$</sam-account-name>
         <description>This is a test universal distribution group</description>
         <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 Create Universal Distribution Group operation:

Sample adapter response for the Create Universal Distribution Group 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>dsadd group "CN=universal-distribution-group,
DC=vm-w23-rds19,DC=local" -secgrp no -scope u -samid 
"UNIVERSAL-DISTRIBUTION-01$" -desc "This is a test universal distribution group"
-members "CN=snayar-pune-01,CN=Computers,
DC=vm-w23-rds19,DC=local" -s "vm-w23-rds19" 
-u "administrator" -p "bmcAdm1n"</command>
         <line-count>6</line-count>
         <execution-milliseconds>829</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 dsadd group
"CN=universal-distribution-group,
DC=vm-w23-rds19,DC=local" -secgrp no -scope u -samid 
"UNIVERSAL-DISTRIBUTION-01$" -desc "This is a test universal distribution group"
-members "CN=snayar-pune-01,CN=Computers,DC=vm-w23-rds19,
DC=local" -s "vm-w23-rds19" -u "administrator" -p "bmcAdm1n"</line>
         <line index="4">Remote application process ID: 6800</line>
         <line index="5">dsadd succeeded:CN=universal-distribution-group,
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*