Share via

nismap

  • Article

Applies To: Windows Server 2008

nismap

NAME

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

SYNOPSIS

nismap add [common_option[...]] -e "mapentry" 
           [-r {yes | no}] [-c conflictfile]mapname
nismap mod [common_option[...]] -e "mapentry" -k keymapname
nismap del [common_option[...]] -k keymapname
nismap create [common_option[...]] -i fieldnum -g separator[-y]mapname

DESCRIPTION

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

-aAD_domain

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

-flogfile

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.

-sserver

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.

-uusr

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.

-ppword

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.

-h/-?

Displays usage information for the command.

The following command arguments are accepted by nismap:

Term Definition

add

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.

mod

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.

del

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.

create

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.

Note

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.