CLI Reference > Server Administration Commands > im creategroup
 
im creategroup
creates a group
Synopsis
im creategroup [--name=value] [--description=value] [--image=[none|default|<path>] [--email=value] [--notificationRule=rule] [--queryTimeout=value] [--sessionLimit=value] [--notificationRuleFile=value] [--copyNotification=[user|group]:<name>] [--[no]active] [--[no]allowNonRealm] [-Ffile|--selectionFile=file] [--name=value] [--user=name] [--hostname=server] [--password=password] [--port=number] [-?|--usage] [-N|--no] [-Y|--yes] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [--quiet] [-g|--gui] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
Description
im creategroup creates a group for workflows and documents. By default, the group must exist in the realm. You can create groups in Integrity Lifecycle Manager by importing groups from a user authentication realm. For example:
im creategroup --name=Services --description=Provides_services_to_customers --image=/admin/creategroup/services.jpg
creates the Services group with a description and custom image.
Options
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
--name=value
specifies the name of the group to create. Names can be a maximum of 100 characters and cannot contain square brackets. This option is mandatory.
* 
PTC recommends that you do not use commas, colons, or special characters in group names. If you use commas in the group name, you cannot select the group in a multi-valued user field. If you use colons in the group name, the group cannot edit shared system provided objects (charts, queries, reports, and dashboards).
--description=value
specifies a description of the group.
--image=[none|default|<path>]
specifies whether an image appears for the group.
--image=none does not specify an image for the group.
--image=default specifies the default "group" image for the group.
--image=<path> specifies the path and name of a custom image for the group, for example, c:\images\group_icon.gif.
* 
Images must be GIF or JPEG format, and no larger than 16 by 24 pixels.
--email=value
specifies the e-mail address of the group.
--notificationRule=rule
specifies the notification rule for this principal. For the rule syntax, see Specifying Rules on the options reference page.
* 
To specify a date and time for a date field, use the MM/dd/yyyy h:mm:ss [AM|PM] format. You can specify a time only if the date field is configured to display the time. To specify the current date for a date field, type today. This option can be specified for a date field or a date field configured to display the date and time. To specify the current date and time for a date field, type now. This option can be specified only if the date field is configured to display the date and time. To specify an empty value for the date field, type none.
E-mail notification is subject to project, type, and field visibility rules. Only users that have visibility for a given project and type receive e-mail notification for issues related to that project and type. In addition, e-mail notifications include only the fields they have permission to view.
--notificationRuleFile=value
specifies the file that contains the rules to read. For the file content format, see Specifying Rules on the options reference page.
--queryTimeout=value
specifies the total time in seconds allowed for queries performed by members of the specified group.
--sessionLimit=value
specifies the number of sessions each user in the group can open at one time. This option assists in managing resource allocation for the Integrity Lifecycle Manager Server. For example, if you specify 5, a user can begin a session in the Web interface, and open 5 tabs in a browser to run a chart in each tab. You can specify a maximum of 100 connections. Default is 5; however, a value of 0 specifies the default value.
* 
If there are Web interface users with heartbeat and idle timeout, then an idle-timed-out user still continues to exist, and is not subject to this limit.
--copyNotification=[user|group]:<name>
copies the given user/group's notification rules. This command copies the given user/group's notification rule into this group's at the time that the command is run. The command does not create a pointer to another notification rule.
--[no]active
Specifies if the group is actively used in Integrity Lifecycle Manager. This option is useful for removing groups that are no longer needed. Specifying --noactive prevents the group from being displayed in group drop-down lists; however, the group still appears in existing issue data.
--[no]allowNonRealm
confirms the non-realm allowance. By default, you cannot import a group into the Integrity Lifecycle Manager database unless that group exists in the current realm. This option allows you to override the requirement that the group needs to be in the realm. --noallowNonRealm is specified by default.
See Also
Commands: im editgroup, im viewgroup, im deletegroup, im groups
Miscellaneous: options