Determines the identity of a user or group using its name.
Resolve-Identity [-Name] <String> [<CommonParameters>]
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:
System.Security.Principal.SecurityIdentifier
object.If the name doesn't represent an actual user or group, an error is written and nothing is returned.
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
Name | String | The name of the identity to return. | true | false |
Carbon.Identity.
Resolve-IdentityName -Name 'Administrators'
Returns an object representing the Administrators
group.