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 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 |
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 |
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:
- add_map_entry or add_map_entry_with_comment adds an entry to the current NIS map stored in memory.
- delete_map_entry removes an entry from the current NIS map.
- delete_nis_map deletes the selected NIS map from Active Directory and from memory.
- get_nis_map or get_nis_map_with_comment returns a Tcl list of the map entries in the current NIS map.
- get_nis_map_field reads a field value from the current NIS map.
- list_nis_map or list_nis_map_with_comment lists to
stdout
the map entries in the current NIS map. - save_nis_map saves the selected NIS map with its current entries to Active Directory.