List

Lists all profiles or element/profile assignments.

If neither --name option nor --entity option is specified, then all the user or host profiles are listed, depending on the --scope option.

If the --name option is specified, then all the elements assigned to this profile are listed.

If the --entity option is specified, then all the profiles assigned to the element specified are listed.

Syntax

list [--scope=<user|host>] [--entity=<entity>] [--name =<profile name>]

--scope=<user|host> : the scope for the profile, which can be either user or host. If not specified, then defaults to the user scope.

--entity=<entity> : the element where the profile is located, if the --name option is specified. Otherwise, the element to which profiles to be listed are assigned. If not specified in the former case, then defaults to the root organization or domain element, depending on the --scope option.

--name=<profile name> : the name of the profile whose assigned elements are to be listed. If no profile or more than one profile with this name and this scope can be found at this layer, then the command exits with an error.

Example 3–6 Listing assignments

% pgtool list

Lists the profiles assigned to root organization.

% pgtool list --scope=host --name=HostProfile1

Lists elements assigned to profile “HostProfile1” located in root domain.