Syntax

create [--username=<name>] [--name=<policy group name>] [--scope=<user/host>] [--entity=<entity name>] [--priority=<priority integer>]

--username=<name> : the username of the administrator in the format used by the configuration repository, for example “jmonroe”.

--name=<policy group name> : this specifies the name for the policy group. If a policy group with this name and this scope already exists at this level then the command exits with an error. This option may not be used with the --entity option as entity policy groups have restricted default names.

--scope=<user/host> : specifies the scope for the policy group, which can either be user or host. If not specified then defaults to the user scope.

--entity=<entity name> : the entity where the policy group is created. If this option is not specified then the policy group is part of the policy group repository. This option may not be used with the --name option as entity policy groups have restricted default names.

--priority=<priority integer> : an integer (>=1) specifying the priority of the policy group. This option may not be used with the --entity option as entity policy groups have default priorities that may not be changed. If the priority specified is the same as that of an existing policy group of this scope at this layer then the command exits with an error. If the priority is not specified, then one is assigned.

Example 3–2 Creating a new policy group

% pgtool create --username=jmonroe --scope=host --name=NewHostGroup1

Creates a new policy group called “NewHostGroup1” whose scope is “host”.