Create Global Distribution Group operation
The Create Global Distribution Group operation creates a new global distribution group.
The following table describes the elements for the <items> XML element and adapter request for the Create Global Distribution Group operation:
Elements for the <items> XML element and adapter request for the Create Global Distribution Group operation
The following figure shows a sample adapter request for the Create Global Distribution Group operation:
Adapter request for the Create Global 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>Global Distribution Group</object-class>
<object-distinguished-name>CN=global-distribution-group,
DC=vm-w23-rds19,DC=local</object-distinguished-name>
<parameters>
<sam-account-name>GLOBAL-DISTRIBUTION-01$</sam-account-name>
<description>This is a test global distribution group</description>
<server>vm-w23-rds19</server>
<user-name>administrator</user-name>
<password>bmcAdm1n</password>
</parameters>
</command>
</commands>
</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>Global Distribution Group</object-class>
<object-distinguished-name>CN=global-distribution-group,
DC=vm-w23-rds19,DC=local</object-distinguished-name>
<parameters>
<sam-account-name>GLOBAL-DISTRIBUTION-01$</sam-account-name>
<description>This is a test global 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 Global Distribution Group operation:
Sample adapter response for the Create Global 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=global-distribution-group,
DC=vm-w23-rds19,DC=local" -secgrp no -scope g -samid
"GLOBAL-DISTRIBUTION-01$" -desc
"This is a test global distribution group" -members
"CN=rnayar-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>828</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=global-distribution-group,DC=vm-w23-rds19,
DC=local" -secgrp no -scope g -samid
"GLOBAL-DISTRIBUTION-01$" -desc "This is a test global distribution group" -members
"CN=rnayar-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: 8780</line>
<line index="5">dsadd succeeded:CN=global-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>
<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=global-distribution-group,
DC=vm-w23-rds19,DC=local" -secgrp no -scope g -samid
"GLOBAL-DISTRIBUTION-01$" -desc
"This is a test global distribution group" -members
"CN=rnayar-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>828</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=global-distribution-group,DC=vm-w23-rds19,
DC=local" -secgrp no -scope g -samid
"GLOBAL-DISTRIBUTION-01$" -desc "This is a test global distribution group" -members
"CN=rnayar-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: 8780</line>
<line index="5">dsadd succeeded:CN=global-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*