Resolve-IdentityName

Determines the full, NT identity name for a user or group.

Syntax

Resolve-IdentityName [-Name] <String> [<CommonParameters>]

Description

The common name for an account is not always the canonical name used by the operating system. For example, the local Administrators group is actually called BUILTIN\Administrators. This function converts an identity's name into its canonical name.

If the name doesn't represent an actual user or group, an error is written and nothing returned.

Parameters

Name Type Description Required? Pipeline Input Default Value
Name String The name of the identity whose canonical name to return. true false

Return Values

System.String.

EXAMPLE 1

Resolve-IdentityName -Identity 'Administrators'

Returns BUILTIN\Administrators, the canonical name for the local Administrators group.