Applies To: Windows Server 2008 R2, Windows Server 2012



nismap - Windows command-line utility to manage Network Information Service (NIS) maps


nismap add 
   -e "
    }] [
nismap mod 
   -e "
  " -k 
nismap del 
nismap create 


The nismap Windows command-line utility manages the Network Information Service (NIS) map specified by mapname maintained by Server for NIS on a local computer or a remote computer. If you are logged on with an account that does not have the required privileges, you can specify the user name and password of an account that does. The specific action that nismap performs depends on the command argument you specify.

In addition to specific command arguments, nismap accepts the following common options and arguments, represented by common_option in the command synopsis:

Term Definition


The name of the NIS domain in Active Directory. This option is not available for the create command argument.


Specifies the fully qualified path and name of the log file. Logged events are appended to this file. The default path and file name is %temp%\conflicts.log.


Specifies the name of the domain controller. The default is the domain controller of the domain of the computer on which the command is executed.


Specifies the user name of the user whose credentials are to be used. It might be necessary to add the domain name to the user name in the form domain\username .


Specifies the password of the user specified using the -u option. If you specify the -u option but omit the -p option, you are prompted for the user's password.


Displays usage information for the command.

The following command arguments are accepted by nismap :

Term Definition


Adds a map entry. The following options and arguments are used with add :

  • -e "mapentry"    Specifies the new map entry as a string in the appropriate NIS map format. The string must be enclosed in quotation marks ( " " ).

  • -r {yes | no}    Specifies whether the existing object in Active Directory is to be replaced with this entry. The default is no .

  • -cconflictfile    Specifies the name of the file in which conflict information is to be recorded. If this option is not provided, a default file name is used.


Modifies an existing map entry. The following options and arguments are required with mod

  • -e "mapentry"    Specifies the replacement map entry as a string in the appropriate NIS map format. The string must be enclosed in quotation marks ( " " ).

  • -kkey    Specifies the search key that identifies the map entry to be modified.


Deletes an existing map entry. The following option and argument are required with del :

  • -kkey    Specifies the search key that identifies the map entry to be deleted.


Creates a structure for a nonstandard map. The following options and arguments are required with create :

  • -ifieldnum    Specifies the field number of the key field.

  • -gseparator    Specifies the character that separates fields in the map.

  • -y    Specifies that the key is not part of the value for this map.


When you use nismap to delete a user, group, or host object, only the UNIX attributes of the object are deleted from Active Directory. To delete the object from Active Directory, use the Active Directory administration tools.
Do not use nismap to change a user's password. Use net.exe or the Windows interface (CTRL+ALT+DELETE) instead. The nismap utility will fail if you change the passwd entry using the nismap mod command. This value is the encrypted string of the user's password. If you need to change the passwd entry, use ypcat(1w) or ypmatch(1w) to retrieve the user's current passwd entry and to ensure that the password field is identical.
If you try to modify a mail alias using the nismap mod command, Server for NIS adds the new alias to the original one instead of replacing it. To change the alias, first use nismap del to delete the original alias, and then use nismap add to add the modified alias.

See Also


Edit standard and nonstandard map entries using the command line interface
Adding or removing UNIX subordinate servers
Migrating and Managing Standard and Nonstandard Maps
Setting UNIX passwords to special values
Create the structure of a nonstandard map