HelperFunctions

2.3.4

Public/Get-UserFromSID.ps1

function global:Get-UserFromSID
{
    <#
        .EXTERNALHELP HelperFunctions.psm1-Help.xml
    #>

    [CmdletBinding()]
    [OutputType([System.Security.Principal.NTAccount])]
    param
    (
        [Parameter(Mandatory = $true,
                 Position = 0,
                 HelpMessage = 'Enter the SID to query.')]
        [string]$ObjectSID
    )

    begin
    {
        $objSID = New-Object System.Security.Principal.SecurityIdentifier($ObjectSID)
    }
    process
    {
        $objUser = $objSID.Translate([System.Security.Principal.NTAccount])
    }
    end
    {
        $objUser.Value
    }
}#ebd function Get-UserFromSID