get_local_group_profile_field

Use the get_local_group_profile_field command to display the value of the specified field for the currently selected local UNIX or Linux group that has a profile defined in the current zone. Before executing this command, you must select a local group by executing the select_local_group_profile command.

Zone type

Hierarchical only.

Syntax

get_local_group_profile_field field_name

Abbreviation

glgpf

Options

This command takes no options.

Arguments

This command takes the following argument:

Argument Type Description

Argument	Type	Description
field_name		Required. Specifies the local group field to retrieve. The data type depends on the field. The possible values are: gid: The numeric group identifier. name: The UNIX name of the group. member: The UNIX name of at least one group member. profileflag: The value of the group’s profile flag as set in the group object in the zone. For the group to be managed by the agent, the profile flag must be set to `1` or `3`. If set to `1`, the group profile is enabled. If the group profile is complete and the profile flag is set to `1`, the profile will be installed or updated in `/etc/group` at the next local account refresh interval. If set to 3, the group profile is removed from `/etc/group` at the next local account refresh interval. dn: The distinguished name of the group. createTime: The creation time of the group profile. modifyTime: The most recent modification time of the group profile. You can also specify AIX extended attributes as the field to get an extended attribute value for a group. Extended attribute fields start with the `aix.` prefix. For example, the `admin` extended attribute can be retrieved by specifying `aix.admin` as the field.

field_name

Required. Specifies the local group field to retrieve. The data type depends on the field. The possible values are:

gid: The numeric group identifier.
name: The UNIX name of the group.
member: The UNIX name of at least one group member.
profileflag: The value of the group’s profile flag as set in the group object in the zone. For the group to be managed by the agent, the profile flag must be set to 1 or 3.
If set to 1, the group profile is enabled. If the group profile is complete and the profile flag is set to 1, the profile will be installed or updated in /etc/group at the next local account refresh interval.
If set to 3, the group profile is removed from /etc/group at the next local account refresh interval.
dn: The distinguished name of the group.
createTime: The creation time of the group profile.
modifyTime: The most recent modification time of the group profile.

You can also specify AIX extended attributes as the field to get an extended attribute value for a group. Extended attribute fields start with the aix. prefix. For example, the admin extended attribute can be retrieved by specifying aix.admin as the field.

Return value

This command returns the value of the specified field.

Examples

The following example returns the GID of the currently selected local group in the zone.

get_local_group_profile_field gid

The following example returns the value of the profile flag for the currently selected local group. In this example, the profile flag is 1, meaning that the group profile in /etc/group will be updated with the latest settings from the local account zone object at the next local account refresh interval.

get_local_group_profile_field profileflag

If the current group is on AIX, you can get group extended attributes and values. For example, to find out if the current group is an administrative group, you can get the admin extended attribute:

get_local_group_profile_field aix.admin

true

Related commands

The following related ADEdit commands let you view and administer local UNIX and Linux users and groups that have profiles defined in the current zone:

delete_local_group_profile deletes a local UNIX or Linux group that has a profile defined in the current zone.
delete_local_user_profile deletes a local UNIX or Linux user that has a profile defined in the current zone.
get_local_groups_profile displays a TCL list of profiles for local groups that are defined in the current zone.
get_local_user_profile_field displays the value of a profile field for the currently selected local UNIX or Linux user that has a profile defined in the current zone.
get_local_users_profile displays a TCL list of profiles for local users that are defined in the current zone.
list_local_groups_profile displays a list of local UNIX and Linux groups that have a profile defined in the current zone.
list_local_users_profile displays a list of local UNIX and Linux users that have a profile defined in the current zone.
new_local_group_profile creates an object for a local UNIX or Linux group in the currently selected zone.
new_local_user_profile creates an object for a local UNIX or Linux user in the currently selected zone.
save_local_group_profile saves the currently selected local UNIX or Linux group object after you create the group object or edit profile field values in the group object.
save_local_user_profile saves the currently selected local UNIX or Linux user object after you create the user object or edit profile field values in the user object.
select_local_group_profile selects a local UNIX or Linux group object for viewing or editing.
select_local_user_profile selects a local UNIX or Linux user object for viewing or editing.
set_local_group_profile_field sets the value of a field for the currently selected local UNIX or Linux group that has a profile defined in the current zone.
set_local_user_profile_field sets the value of a field for the currently selected local UNIX or Linux user that has a profile defined in the current zone.