mapadmin
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:
|
| add | Creates a new mapping for a user or group. The following options are available with this parameter:
|
| 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:
|
| delete | Removes the mapping for a user or group. The following options are available for this parameter:
|
| list | Displays information about user and group mappings. The following options are available with this parameter:
|
| 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:
|
| removedomainmap | Removes a simple map between a Windows domain and an NIS domain. The following options and argument are available for this parameter:
|
| 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, orPCNFS\<username>For UNIX groups, use the formats:
<NISdomain>\<groupname>,<groupname>@<NISdomain>,<groupname>@PCNFS, orPCNFS\<groupname>