Edit

mapadmin

  • Article

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.

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

Parameters

Parameter Description
<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.
start | stop Starts or stops the User Name Mapping service.
config Specifies general settings for User Name Mapping. The following options are available with this parameter:
  • -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, mapping is turned on.
add Creates a new mapping for a user or group. The following options are available with this parameter:
  • -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 parameter:
  • -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 parameter:
  • -wu <user>: Specifies 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.

  • -uu <user>: Specifies 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.

  • -wg <group>: Specifies the Windows group for which the mapping will be deleted, specified as <windowsdomain>\<username>.

    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.

  • -ug <group>: Specifies 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 parameter:
  • -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 parameter.
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 parameter:
  • -d <windowsdomain>: Specifies the Windows domain to be mapped.
  • -y <NISdomain>: Specifies the NIS domain to be mapped. You must use the -n <NISserver> parameter to specify the NIS server for the NIS domain specified by 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 can't 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 parameter:
  • -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.

Remarks

  • If you don't specify any paramters, the mapadmin command 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 formats: <domain>\<username>, \\<computer>\<username>, \<computer>\<username>, or <computer>\<username>

    • For Windows groups, use the formats: <domain>\<groupname>, \\<computer>\<groupname>, \<computer>\<groupname>, or <computer>\<groupname>

    • For UNIX users, use the formats: <NISdomain>\<username>, <username>@<NISdomain>, <username>@PCNFS, or PCNFS\<username>

    • For UNIX groups, use the formats: <NISdomain>\<groupname>, <groupname>@<NISdomain>, <groupname>@PCNFS, or PCNFS\<groupname>