mapadmin
Applies To: Windows Server 2003 R2
You can use Mapadmin to manage User Name Mapping for Microsoft Services for Network File System.
Syntax
mapadmin [computer] [-u user [-p password]]
mapadmin [computer] [-u user [-p password]] {start | stop}
mapadmin [computer] [-u user [-p password]] config option[...]
mapadmin [computer] [-u user [-p password]] add -wu WindowsUser -uu UNIXUser [-setprimary]
mapadmin [computer] [-u user [-p password]] add -wg WindowsGroup -ug UNIXGroup [-setprimary]
mapadmin [computer] [-u user [-p password]] setprimary -wu WindowsUser [-uu UNIXUser]
mapadmin [computer] [-u user [-p password]] setprimary -wg WindowsGroup [-ug UNIXGroup]
mapadmin [computer] [-u user [-p password]] delete option[...]
mapadmin [computer] [-u user [-p password]] list option[...]
mapadmin [computer] [-u user [-p password]] backup filename
mapadmin [computer] [-u user [-p password]] restore filename
mapadmin [computer] [-u user [-p password]] adddomainmap -d WindowsDomain {-y NISDomain | -f path}
mapadmin [computer] [-u user [-p password]] removedomainmap -d WindowsDomain -y NISDomain
mapadmin [computer] [-u user [-p password]] removedomainmap -all
mapadmin [computer] [-u user [-p password]] listdomainmaps
Description
The mapadmin command-line utility administers User Name Mapping on the local or remote computer running Microsoft Services for Network File System. If you are logged on with an account that does not have administrative credentials, you can specify a user name and password of an account that does.
In addition to specific command arguments, mapadmin accepts the following arguments and options:
- computer
Specifies the remote computer running the User Name Mapping service that you want to administer. You can specify the computer using a Windows Internet Name Service (WINS) name or a Domain Name System (DNS) name, or by Internet Protocol (IP) address.
- -u user
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.
- -p password
Specifies the password of the user. If you specify the -u option but omit the -p option, you are prompted for the user's password.
The specific action that mapadmin performs depends on the command argument you specify:
- start
Starts the User Name Mapping service.
- stop
Stops the User Name Mapping service.
config
Specifies general settings for User Name Mapping. The following options are available with this command argument:-r dddd:hh:mm
Specifies the refresh interval for updating from the Windows and NIS databases in days, hours, and minutes. The minimum interval is 5 minutes.
-i yes | no
Turns simple mapping on (yes) or off (no). By default, simple mapping is on.
add
Creates a new mapping for a user or group. The following options are available with this command argument:
Term Definition -wu name
Specifies the name of the Windows user for which a new mapping is being created.
-uu name
Specifies the name of the UNIX user for which a new mapping is being created.
-wg group
Specifies the name of the Windows group for which a new mapping is being created.
-ug group
Specifies the name of the UNIX group for which a new mapping is being created.
-setprimary
Specifies that the new mapping is the primary mapping.
setprimary
Specifies which mapping is the primary mapping for a UNIX user or group with multiple mappings. The following options are available with this command argument:
Term Definition -wu name
Specifies the Windows user of the primary mapping. If more than one mapping for the user exists, use the -uu option to specify the primary mapping.
-uu name
Specifies the UNIX user of the primary mapping.
-wg group
Specifies the Windows group of the primary mapping. If more than one mapping for the group exists, use the -ug option to specify the primary mapping.
-ug group
Specifies the UNIX group of the primary mapping.
delete
Removes the mapping for a user or group. The following options are available for this command argument:
Term Definition -wu user
The Windows user for which the mapping will be deleted, specified as WindowsDomain\UserName. You must specify either the -wu or the -uu option, or both. If you specify both options, the particular mapping identified by the two options will be deleted. If you specify only the -wu option, all mappings for the specified user will be deleted.
-wg group
The Windows group for which the mapping will be deleted, specified as WindowsDomain\GroupName. You must specify either the -wg or the -ug option, or both. If you specify both options, the particular mapping identified by the two options will be deleted. If you specify only the -wg option, all mappings for the specified group will be deleted.
-uu user
The UNIX user for whom the mapping will be deleted, specified as UserName. You must specify either the -wu or the -uu option, or both. If you specify both options, the particular mapping identified by the two options will be deleted. If you specify only the -uu option, all mappings for the specified user will be deleted.
-ug group
The UNIX group for which the mapping will be deleted, specified as GroupName. You must specify either the -wg or the -ug option, or both. If you specify both options, the particular mapping identified by the two options will be deleted. If you specify only the -ug option, all mappings for the specified group will be deleted.
list
Displays information about user and group mappings. The following options are available with this command argument:
Term Definition -all
Lists both simple and advanced mappings for users and groups.
-simple
Lists all simple mapped users and groups.
-advanced
Lists all advanced mapped users and groups. Maps are listed in the order in which they are evaluated. Primary maps, marked with an asterisk (*), are listed first, followed by secondary maps, which are marked with a carat (^).
-wu name
Lists the mapping for a specified Windows user.
-wg group
Lists the mapping for a Windows group.
-uu name
Lists the mapping for a UNIX user.
-ug group
Lists the mapping for a UNIX group.
backup
Saves User Name Mapping configuration and mapping data to the file specified by filename.
restore
Replaces configuration and mapping data with data from the file (specified by filename) that was created using the backup command argument.
adddomainmap
Adds a simple map between a Windows domain and an NIS domain or password and group files. The following options are available for this command argument:
Term Definition -d WindowsDomain
Specifies the Windows domain to be mapped.
-y NISDomain
Specifies the NIS domain to be mapped.
- -n nisServer
- Specifies the NIS server for the NIS domain specified with the -y option.
-f path
Specifies the fully qualified path of directory containing the password and group files to be mapped. The files must be located on the computer being managed, and you cannot use mapadmin to manage a remote computer to set up maps based on password and group files.
removedomainmap
Removes a simple map between a Windows domain and an NIS domain. The following options and argument are available for this command argument:
Term Definition -d WindowsDomain
Specifies the Windows domain of the map to be removed.
-y NISDomain
Specifies the NIS domain of the map to be removed.
-all
Specifies that all simple maps between Windows and NIS domains are to be removed. This will also remove any simple map between a Windows domain and password and group files.
listdomainmaps
Lists the Windows domains that are mapped to NIS domains or password and group files.
If you do not specify a command argument, mapadmin displays the current settings for User Name Mapping.
For all options that specify a user or group name, the following formats can be used:
For Windows users, use the form domain\username, \\computer\username, \computer\username, or computer\username
For Windows groups, use the form domain\groupname, \\computer\groupname, \computer\groupname, or computer\groupname
For UNIX users, use the form NISdomain\username, username**@**NISdomain, username@PCNFS, or PCNFS\username
For UNIX groups, use the form NISdomain\groupname, groupname**@**NISdomain, groupname@PCNFS, or PCNFS\groupname