list groups

list groups

Usage:

Style 1:

tbutil [{cred}] list [{source}] [{type}] groups [-l|-j|-s ..|-y|-x ..] [-columns ..] [-jsfilter ..] [-q ..] [{member_type}]

Style 2:

tbutil [{cred}] list [cluster] {category} groups {format_options} [-count-direct] [-show-targets] [-jsfilter ..]

Style 1 of this command lists groups by type and source.

Style 2 lists groups by their parentage in the group hierarchy.

In style 1, the {source} may be..

Source	Meaning
	If no source is specified, the default list of groups (those returned by the search API) of the selected type is printed.
all	The listing includes all groups, including the ones the system hides from the "Search" APIs (this needs some definition).
discovered	Groups that have been discovered from targets are listed.
my	Groups that have been configued by a user are listed.

Note: if a source is specified, the -q option cannot be used.

In style 1, the {type} may be...

Type	Meaning
	If not type is specified, the listing includes both static and dynamic groups.
dynamic	Limit the list to dynamic groups only.
static	Limit the list to static groups only.

In style 2, the {category} may be...

Category	Meaning
pm	Lists the groups in the GROUP-PMGroups or GROUP-PhysicalMachineByCluster hierarchy (depending on whether the word "cluster" is specified).
storage	Lists the groups in the GROUP-STGroups or GROUP-StorageByCluster hierarchy (depending on whether the word "cluster" is specified).
vm	Lists the groups in the GROUP-VMGroups or GROUP-VirtualMachineByCluster hierarchy (depending on whether the word "cluster" is specified)..

These commands support the following set of common format_options: -l, -j, -s, -y, -x and -columns.

If the -jsfilter option is specified then the tool loads and runs the specified filter script. Only the sub-set of groups for which the function returns true are included in the listing.

A subset of the commands support the -q option to allow the search API to return only the subset of groups who's display names match the specified regular expression.

See also: create static group, delete group, export group, import group list group members, list related groups