Removing users and groups by using the wsadmin tool

Use these commands to remove a user or group. Removing a user or group withdraws the authorization permissions for all roles to which they have previously been added.

To run these commands, use the AdminTask object of the wsadmin scripting client. Each command acts on multiple objects in one operation. The commands are provided to allow you to make the most commonly-required types of update in a consistent manner, where modifying the underlying objects directly would be error-prone.

[IBM i][IBM i]The wsadmin scripting client is run from Qshell.

Command-line help is provided for service integration bus commands:
  • For a list of the available service integration bus security commands in Jython and a brief description of each command, enter the following command at the wsadmin prompt:

    print AdminTask.help('SIBAdminBusSecurityCommands')

  • For overview help on a given command, enter the following command at the wsadmin prompt:

    print AdminTask.help('command_name')

After using the command, save your changes to the master configuration by using the following command:

AdminConfig.save()

Commands

Removing a user
To remove a user from all the roles that they belong to, use the following command:
  • Using Jython:
    AdminTask.removeUserFromAllRoles("-bus busname -user userName")
  • Using Jacl:
    $AdminTask removeUserFromAllRoles {-bus busname -user userName}
    
Removing a group
To remove a group from all the roles that it belongs to, use the following command:
  • Using Jython:
    AdminTask.removeGroupFromAllRoles("-bus busname -group groupName")
  • Using Jacl:
    $AdminTask removeGroupFromAllRoles {-bus busname -group groupName}
    

After using these commands, save your changes to the master configuration; for example, by using the following command:

AdminConfig.save()