Resolve-Identity

Determines the identity of a user or group using its name.

Syntax

Resolve-Identity [-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 uses the LookupAccountName Windows function to resolve an account name into its domain, name, full name, SID, and SID type. It returns a Carbon.Identity object with the following properties:

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

Related Commands

Parameters

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

Return Values

Carbon.Identity.

EXAMPLE 1

Resolve-IdentityName -Name 'Administrators'

Returns an object representing the Administrators group.