Manipulate management groups.

Syntax

group -add [group-name [subgroup-name[,...]]]

group -delete group-name

group -list [group-name]

group -modify group-name [subgroup-name[,...]]

Command Switches
-add
-confirm
-delete
-format_file=file-spec
-list
-log
-modify
-output=file-spec
-prompt
-recur

Parameters

group-name

Name of the group to add, delete, list, or modify. Wild cards can be used in conjunction with the -list switch.

subgroup-name[,...]

A comma separated list group names to associated with the group being added or modified. The listed groups will become subgroups of the group being added or modified.

Description

The group command is used to manipulate the popstore management groups. Only managers with either operating system privileges or a privileged popstore account with access to the world group can use this command. In regards to the latter case, that means that the manager's account must have the MANAGE usage flag set and either have no group name associated with the account---the empty group---or be in a management group which contains as a subgroup the world group. The one exception to this rule is that a manager can always use the -list switch to list their own management group and subgroups thereof. For further details on the usage of this command as well as usage examples, see Section 6.12.

Command Switches

-add

This switch indicates that a new management group is to be added. If a group already exists with the same name, then an error will be output.

-confirm

-noconfirm (default)

Prompt for positive confirmation before carrying out the indicated operation. -noconfirm is the default behavior.

-delete

This switch indicates that the specified management group is to be deleted. Note that subgroups contained within the group are not deleted unless -recur is also specified. Moreover, the actual accounts in the group are not deleted either. They can only be deleted with a delete -group=group_name * command.

-format_file=file-spec

Specify a formatting file to use to format the output of a group -list command.

-list

List the specified groups and subgroups. When this switch is used, the group-name parameter can contain wild card characters. When the parameter is omitted, * is assumed.

-log

-nolog (default)

When the operation is successful, output a status message stating that the operation succeeded. Note that error messages are always indicated. -nolog is the default behavior.

-modify

Modify the specified group, replacing its list of subgroups with the specified list. If no list is specified, then the group is changed to contain no subgroups.

-output=file-spec

Write the output to the specified file rather than to the terminal. The file will be created as a new file each time it is specified.

-prompt (default)

-noprompt

By default if a wildcard is used, even if -noconfirm is specified, one confirmation prompt is issued. If -noprompt is specified, there is no prompting at all. This qualifier can be used in conjunction with the -add, -delete, or -modify switches.

-recur

-norecur (default)

This qualifier can be used in conjunction with the -delete switch. By default, only the specified group is deleted. Subgroups of that group are not deleted unless -recur is also specified.