create_group

Use the create_group command to create a new zone group for the currently selected zone. This command creates the new group based on an existing Active Directory group. It also assigns the new group a new UNIX profile that includes the UNIX group name and the UNIX group numeric identifier (GID).

Syntax

create_group upn name gid ?req?

Options

This command takes no options.

Arguments

This command takes the following arguments:

Argument Type Description

upn

string

Required. Specifies the user principal name of the Active Directory group to use as the basis for the new zone group.

name

string

Required. Specifies the UNIX group name of the new zone group.

For hierarchical zones only, specifying “-” unsets the name value.

gid

string

Required. Specifies the UNIX group ID to assign to the new zone group.

For hierarchical zones only, specifying “-” unsets the gid value.

req

string

Optional. Specifies whether the zone group is required. Set the value to 1, y, yes, or true if the group is required in the zone or to 0, n, no, or false if the group in not required in the zone. All other values throw an exception.

If a group is required, users cannot remove the group from their active set of groups.

Return value

This command returns nothing if it runs successfully.

Examples

create_group pubs@acme.com pubs 1094

Related Tcl library commands

The following commands perform actions related to this command:

  • create_aduser creates a new Active Directory user account and sets its password.
  • create_adgroup creates a new Active Directory group account and specifies its scope.
  • create_user creates a new zone user based on an existing Active Directory user, assigns field values to the new user, and saves the new user to Active Directory.
  • add_user_to_group adds an Active Directory user to an Active Directory group.
  • remove_user_from_group removes an Active Directory user from an Active Directory group.