API Reference
Class
IdentityConverter
Central identity converter akin to Convert-Identity in PowerShell: accepts SID, UPN, SAM, DN, NT SERVICE, etc. and returns a normalized IdentityInfo with DisplayName set.
Inheritance
- Object
- IdentityConverter
Remarks
Uses a fast directory lookup with a short time budget and falls back to cached translation for resiliency. Prefer IdentityExtensions one-liners for most call sites.
Methods
public static Void AddKnown(String sidValue, String displayName) #Returns:
VoidAdds or overrides a custom mapping. Useful to seed environment-specific service accounts.
Parameters
- sidValue System.String
- SID to map.
- displayName System.String
- Desired display name.
public static IdentityInfo Convert(String identity) #Returns:
IdentityInfoConverts any identity string to an IdentityInfo (name, SID, domain, type, error).
Parameters
- identity System.String
- Identity as SID, UPN, SAM, or distinguished name.
Returns
Resolved IdentityInfo backed by the global cache.
public static IEnumerable<IdentityInfo> ConvertIdentities(IEnumerable<String> identities, Int32 maxConcurrency = 0) #Returns:
IEnumerable<IdentityInfo>Converts a batch of identities to IdentityInfo. If maxConcurrency > 1, resolves in parallel.
Parameters
- identities System.Collections.Generic.IEnumerable{System.String}
- Sequence of identities.
- maxConcurrency System.Int32 = 0
- Max degree of parallelism (optional).
Returns
Resolved identities.
public static IdentityInfo FromSid(String sidValue) #Returns:
IdentityInfoConverts a SID string to an IdentityInfo.
Parameters
- sidValue System.String
- SID string.
Returns
Resolved IdentityInfo.