new_nis_map

Use the new_nis_map command to create a new NIS map for the current zone and set the new NIS map as the currently selected NIS map in memory. The new NIS map has no map entries.

The new_nis_map does not save the new NIS map to Active Directory. To save the new map, you must use save_nis_map. If you don’t save a new NIS map, it will disappear when you select a new NIS map or when the ADEdit session ends.

Zone type

Not applicable

Syntax

new_nis_map [-automount] map

Abbreviation

newnm

Options

This command takes the following option:

Option Description

-automount

Specifies that the new NIS map is an automount map.

For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name netgroup, it must be a NIS netgroup map and contain valid netgroup entries. However, you can specify any name for NIS automount maps. Use this option to identify automount maps that have a name other than automount.

Arguments

This command takes the following argument:

Argument Type Description

map

string

Required. Specifies the name of the new NIS map.

For most NIS maps, the map name defines the type of map you are creating. For example, if you create a new NIS map with the name netgroup, it must be a NIS netgroup map and contain valid netgroup entries. For information about the type of NIS maps you can create, see theNetwork Information Service Administrator’s Guide.

Return value

This command returns nothing if it runs successfully.

Examples

The following command creates the NIS map “Printers” in the current zone.

new_nis_map Printers

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 NIS maps:

  • get_nis_maps returns a Tcl list of NIS maps in the current zone.
  • list_nis_maps lists to stdout the NIS maps in the current zone.
  • 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: