Unsupported content This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Create Local Security Group operation


The Create Local Security Group operation creates a new local security group.

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

 Elements for the <items> XML element and adapter request for the Create Local Security Group operation

The following figure shows a sample adapter request for the Create Local Security Group operation:

Adapter request for the Create Local Security 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>Local Security Group</object-class>
       <object-distinguished-name>CN=local-security-group,
    DC=vm-w23-rds19,DC=local</object-distinguished-name>
       <parameters>
         <sam-account-name>LOCAL-SECURITY-01$</sam-account-name>
         <description>This is a test local security group</description>
         <member-of>CN=Test-Group-1,DC=vm-w23-rds19,DC=local</member-of>
         <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 Local Security Group operation:

Sample adapter response for the Create Local Security 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=local-security-group,DC=vm-w23-rds19,
DC=local" -secgrp yes -scope l -samid "LOCAL-SECURITY-01$" -desc 
"This is a test local security group" -memberof "CN=Test-Group-1,
DC=vm-w23-rds19,DC=local" -members "CN=rohitn-pun-01,
CN=Users,DC=vm-w23-rds19,
DC=local" -s "vm-w23-rds19" -u "administrator" -p "bmcAdm1n"</command>
         <line-count>6</line-count>
         <execution-milliseconds>750</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=local-security-group,DC=vm-w23-rds19,
DC=local" -secgrp yes -scope l -samid "LOCAL-SECURITY-01$" -desc 
"This is a test local security group" -memberof "CN=Test-Group-1,
DC=vm-w23-rds19,DC=local" -members "CN=rohitn-pun-01,CN=Users,
DC=vm-w23-rds19,DC=local" -s "vm-w23-rds19" 
-u "administrator" -p "bmcAdm1n"</line>
         <line index="4">Remote application process ID: 732</line>
         <line index="5">dsadd succeeded:CN=local-security-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*