Loading...

Deleting a User Using the Command Line Interface

Use XML to delete a user and transfer the ownership of entities such as alerts, scheduled policies, and workflows from the deleted user to another user or user group.

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 delete_user_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 delete_user_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 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 delete_user_template.xml

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

Example

  • The following command deletes user "jsmith" and transfers ownership to the "administrators" user group. In this example, the parameters are listed on the command line:

    qoperation execute -af delete_user_template.xml -userEntity/userName jsmith -transferAllFromOldUser 1 -newUserGroup/userGroupName administrators

  • The following command deletes two users and transfers ownership. In this example, the user names and the transfer information are in the XML file:

    qoperation execute -af delete_user_template.xml

    The delete_user_template.xml file contains the following elements:

    <App_DeleteUserRequest>
      <users>
        <userEntity>
          <userName>jsmith</userName>
        </userEntity>
        <transferInfo transferAllFromOldUser="1">
          <newUserGroup>
            <userGroupName>administrators</userGroupName>
          </newUserGroup>
        </transferInfo>
      </users>
      <users>
        <userEntity>
          <userName>lbrown</userName>
        </userEntity>
        <transferInfo transferAllFromOldUser="1">
          <newUser>
           <userName>kcarr</userName>
          </newUser>
        </transferInfo>
      </users>
    </App_DeleteUserRequest>

Last modified: 5/1/2018 3:03:10 PM