Loading...

Editing a User Group Using the Command Line Interface

Use XML to edit a user group. This XML is useful if you want to assign or update security associations or users.

You can include the XML parameters in the xml file, or you can specify them on the command line when they frequently change. For more information on command line parameters and XML elements, see Command Line - Syntax.

Procedure

  1. Run the qlogin command to log on to the CommServe computer.
  2. Download the modify_usergroup_template.xml file to the computer where you will run the command.
  3. To define the parameter values, do either of the following:
    • Open the modify_usergroup_template.xml file and update the XML parameters.
    • Type the parameters on the command line using the following format: -parameter_name parameter_value.

    For information on supported parameters, see XML Parameters for User Group Operations.

  4. On the command line, go to software_installation_directory/Base and type the following command and include any parameters not defined in the .xml file:

    qoperation execute -af modify_usergroup_template.xml

  5. Run the qlogout command to log off the CommServe computer.

Examples

Overwriting an Association

When you perform an operation using the associationsOperationType parameter, the role and the entity must be provided. The entity name must be provided on the command line and in the modify_usergroup_template.xml file. In the following example, storagePolicyName is the entity used in the association. For the list of entity names, see XML Parameters for User Group Operations.

qoperation execute -af modify_usergroup_template.xml -userGroupEntity/userGroupName consultants -associationsOperationType OVERWRITE -role/roleName master -entity/storagePolicyName SP001

<entities>
  <entity>
    <storagePolicyName></storagePolicyName>
  </entity>
</entities>

Adding a User to the User Group

The following command adds a user to a user group. In this example, the parameters are listed on the command line:

qoperation execute -af modify_usergroup_template.xml -userGroupEntity/userGroupName consultants -usersOperationType ADD -users/userName jsmith