list groups

list groups

Usage:

Style 1:

tbutil [{cred}] list [all|my|discovered] [dynamic|static] groups [-l|-j|-s ..|-y|-x ..] [-columns ..] [-jsfilter ..] [-q ..] [-show-targets] [{member_type}]

Style 2:

tbutil [{cred}] list [cluster] vm|pm|storage groups [-l|-j|-s ..|-y|-x ..] [-columns ..] [-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 output may be filtered by the group source..

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.

And/or the output may be filtered by type..

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 output may be filtered by group category..

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 formatting 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"