get_nis_map_field

Use the get_nis_map_field command to return the value for a specified field from the currently selected NIS map stored in memory. The get_nis_map_field command does not query Active Directory for the NIS map. If you’ve changed field values using ADEdit without saving the NIS map to Active Directory, the field value you retrieve using get_nis_map_field won’t match the same field value for the NIS map stored in Active Directory.

Zone type

Not applicable

Syntax

get_nis_map_field field

Abbreviation

gnmf

Options

This command takes no options.

Arguments

This command takes the following argument, which is case-sensitive:

Argument	Type	Description
field	string	Required. Specifies the case-sensitive name of the field whose value to retrieve. The possible values are: createTime: Specifies the time and date this NIS map was created, returned in generalized time format modifyTime: Specifies the time and date this NIS map was last modified, returned in generalized time format dn: Specifies the NIS map’s distinguished name

Return value

This command returns a field value, which varies in type depending on the data type stored by the field.

Examples

get_nis_map_field createTime

This example returns the value of the createTime field. For example: 20110525163718.0Z

Related Commands

Before you use this command, you must have a currently selected NIS map stored in memory. The following commands enable you to view and manage NIS maps:

• delete_nis_map deletes the selected NIS map from Active Directory and from memory.
• get_nis_maps returns a Tcl list of NIS maps in the currently selected zone.
• list_nis_maps lists to stdout all NIS maps in the currently selected zone.
• new_nis_map creates a new NIS map and stores it in memory.
• save_nis_map saves the selected NIS map with its current entries to Active Directory.
• select_nis_map retrieves a NIS map from Active Directory and stores it in memory.

After you have a NIS map stored in memory, you can use the following commands to work with that map’s entries:

• add_map_entry or add_map_entry_with_comment adds an entry to the currently selected NIS map.
• delete_map_entry removes an entry from the currently selected NIS map.
• get_nis_maps or get_nis_map_with_comment returns a Tcl list of NIS maps in the currently selected zone.
• list_nis_map or list_nis_map_with_comment lists to stdout of the entries in the currently selected NIS map.