joined_name_to_principal

Use the joined_name_to_principal command have adclient query Active Directory for a UNIX name of a specified user. If the specified user is found, the command returns the associated Active Directory user name in the format of sAMAccountName@domain. The command can also optionally return the user principal name (UPN) of the user. This command works only for users within the domain to which ADEdit’s host computer is joined through adclient.

Zone type

Not applicable

Syntax

joined_name_to_principal [-upn] UNIX_name

Abbreviation

jntp

Options

This command takes the following option:

Option Description

-upn

Returns the user’s Active Directory name in user principal name (UPN) format.

Arguments

This command takes the following argument:

Argument Type Description

UNIX_name

string

Required. Specifies the UNIX name of a user to look for in Active Directory.

Return value

This command returns the sAMAccountName@domain form of the user name if the user is found in Active Directory. If you specify the -upn option, this command returns the UPN form of user name.

Examples

joined_name_to_principal -upn adam

This example returns the sAMAccountName@domain for the UNIX user adam:

adam.avery@acme.com

Related commands

The following commands performs actions related to this command:

  • principal_to_dn searches Active Directory for a user principal name (UPN) and, if found, returns the corresponding DN.
  • dn_to_principal searches Active Directory for a distinguished name and, if found, returns the corresponding UPN.
  • principal_from_sid searches Active Directory for a security identifier (SID) and returns the security principal associated with the SID.