Resolve-CIdentityName

NAME Resolve-CIdentityName



SYNOPSIS

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





SYNTAX

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



Resolve-CIdentityName -SID <Object> [<CommonParameters>]





DESCRIPTION

`Resolve-CIdentityName` resolves a user/group name into its full, canonical name, used by the operating system.

For example, the local Administrators group is actually called BUILTIN\\Administrators. With a canonical username,

you can unambiguously compare principals on objects that contain user/group information.



If unable to resolve a name into an identity, `Resolve-CIdentityName` returns nothing.



If you want to get full identity information (domain, type, sid, etc.), use `Resolve-CIdentity`.



In Carbon 2.0, you can also resolve a SID into its identity name. The `SID` parameter accepts a SID in SDDL form

as a `string`, a `System.Security.Principal.SecurityIdentifier` object, or a SID in binary form as an array of

bytes. If the SID no longer maps to an active account, you'll get the original SID in SDDL form (as a string)

returned to you.





PARAMETERS

-Name <String>

The name of the identity to return.



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SID <Object>

Get an identity's name from its SID. Accepts a SID in SDDL form as a `string`, a

`System.Security.Principal.SecurityIdentifier` object, or a SID in binary form as an array of bytes.



This parameter is new in Carbon 2.0.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

string





-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Resolve-CIdentityName -Name 'Administrators'



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











RELATED LINKS

ConvertTo-CSecurityIdentifier

Resolve-CIdentity

Test-CIdentity

http://msdn.microsoft.com/en-us/library ... ifier.aspx

http://msdn.microsoft.com/en-us/library ... 79601.aspx