set_zone_group_field

Use the set_zone_group_field command to set the value for a specified field in the currently selected zone group stored in memory. The set_zone_group_field command does not set a field value stored in Active Directory for the selected zone group.

If you change any fields, you must save the zone group using the save_zone_group command for your changes to take effect in Active Directory. If you select another zone group or end the ADEdit session before saving the currently selected zone group, your changes will be lost.

Zone type

Classic and hierarchical

Syntax

set_zone_group_field field value

Abbreviation

szgf

Options

This command takes no options.

Arguments

This command takes the following arguments:

Argument Type Description

field

string

Required. Specifies the name of the field that you want to set. The possible values are:

  • gid: Sets the numeric identifier for the group (GID).
  • name: Sets the text string for the group name.
  • required: 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.

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

value

 

Required. Specifies the value to assign to the specified field. The data type depends on the field specified.

In some cases, you can assign a dash (-) to a field to unset the field value. However, this is not supported for all fields or all zone types.

Return value

This command returns nothing if it runs successfully.

Examples

The following example sets the current zone group’s UNIX group name to managers.

set_zone_group_field name managers

If the current group is on AIX, you can set AIX group extended attributes and values. For example, to identify the current group as an administrative group, you can set the admin extended attribute:

set_zone_group_field aix.admin true

Related commands

Before you use this command, you must have a currently selected zone stored in memory. The following commands enable you to view and select zone groups:

  • get_zone_groups returns a Tcl list of the Active Directory names of all zone groups in the current zone.
  • list_zone_groups lists to stdout the zone groups in the current zone.
  • new_zone_group creates a new zone group and stores it in memory.
  • select_zone_group retrieves a zone group from Active Directory and stores it in memory.

After you have a zone group stored in memory, you can use the following commands to work with that zone group: