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: