Reference Guide › Utilities › uxconsole Utility—Manage UNAB Endpoints › uxconsole -map—Manage Users Mapping

uxconsole -map—Manage Users Mapping

Valid on UNIX

Use the map command to NIS or local user accounts to Active Directory user accounts.

Note: When you use the -map option, the uxconsole utility does not connect to Active Directory to identity conflicts in user account details.

This command has the following formats:

uxconsole -map [-add] [-scope {l|n|a}] { -all | <unix_name> [ <ad_name>] | -input <file> } [-d <domain>  ] [-force] [-v]
uxconsole -map -local { <unix_name> | -input <file> } [-force] [-v]
uxconsole -map -del   { <unix_name> | -input <file> } [-force] [-v]
uxconsole -map -show [<filter>] [-scope {l|n|a}] [-v]
uxconsole -map -h

-add

Add users mapping

-scope {l|n|a}

Specifies the mapping scope:

• l—map the local user accounts only
• n—map NIS/NIS+ user accounts only
• a—map local and NIS/NIS+ user accounts

-all

Specifies to map all NIS and or local user accounts with identical user names.

<unix name>

Specifies to map a single UNIX user account, either NIS or local account.

Note: You can also use this parameter to delete mapped NIS or local user accounts.

-ad <ad name>

Specifies the Active Directory name of the local user account.

-input <file>

Specifies an input file containing mapping requests. Create the map file in a CSV format with the following fields and parameters:

<unix_name>,[<ad_name>],[<domain>]

<unix_name>

Specifies the UNIX user account name.

[<ad_name>]

Specifies the Active Directory user account. ad_name is an optional parameter. If you do not specify the Active Directory user account, the account is mapped to an AD account with the same UNIX user account name.

[<domain>]

Specifies the domain name of the Active Directory account. domain is an optional parameter.

-d <domain>

Defines the Active Directory domain name that contains the user account.

Note: You can specify the full user credentials using the following format: <name>@<domain>. If the domain name is not specified, then the domain is mapped to the registration domain.

-force

Specifies to force user mapping and overwrite existing mapping or migration status or delete user mapping.

Note: By default, uxconsole does not delete partially migrated user accounts.

-local

Specifies to set the user account as a local exception.

Note: If you specify a user as local exception, UNAB does not manage the user account, although an identical user account may exist in the Active Directory.

-del

Specifies to delete local or NIS user mapping.

-show

Specifies to display users mapping details.

<filter>

Defines the wildcard that returns a subset of users.

-v

Specifies to activate verbosity.

-h

Displays the help.