ConvertFrom-FsRight.ps1

function ConvertFrom-FsRight {
    <#
.SYNOPSIS
    To convert a [uint32] FileSystemRight value into a human readable form
.DESCRIPTION
    To convert a [uint32] FileSystemRight value into a human readable form using normal text
.PARAMETER Rights
    The filesystemrights value determined by: get-acl -Path $Path | select-object -expand access | select-object FileSystemRights
    Alternatively a [uint32] value could be passed from the command line. Hex values need to be enclosed in quotes.
.PARAMETER IncludeInput
    Switch to include input values in the output
.EXAMPLE
    ConvertFrom-FsRight -Rights "0x1F01FF"
    Would return
    FullControl
.EXAMPLE
    ConvertFrom-FsRight -Rights "0x1301BF"
    Would return
    ReadAndExecute,Modify,Write
.EXAMPLE
    ConvertFrom-FsRight -Rights 268435456
    Would return
    GenericAll
.LINK
    Get-ACL
.OUTPUTS
    A [string] of all the applicable rights in readable form
#>

    #region Parameters
    [CmdletBinding()]
    [OutputType('string')]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '')]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', '')]
    param(
        [Parameter(ValueFromPipeline)]
        [uint64[]] $Rights,

        [switch] $IncludeInput
    )
    #endregion Parameters

    begin {
        Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]"
        $fsPermission = Get-FsRight -Verbose:$false
        $fsPermissionCombo  = $fsPermission | Where-Object { $_.Type -eq 'Combo' }
        $fsPermissionSingle = $fsPermission | Where-Object { $_.Type -ne 'Combo' }
    }

    process {
        foreach ($curRights in $Rights) {
            $temp = New-Object -TypeName System.Collections.Arraylist
            if ($curRights -in $fsPermissionCombo.Dec) {
                $null = $temp.Add(($fsPermissionCombo | Where-Object {$_.Dec -eq $curRights}).Name)
                if ($IncludeInput) {
                    New-Object -TypeName psobject -Property ([ordered] @{
                            Right       = $curRights
                            RightHex    = ('0x{0:x6}' -f $curRights)
                            RightString = ( $temp -join ',' )
                        })
                } else {
                    Write-Output -InputObject ( $temp -join ',' )
                }
            } else {
                $fsPermissionSingle | ForEach-Object {
                    if ($curRights -band $_.Dec) {
                        $null = $temp.Add($_.Name)
                        $MatchFound = $true
                        Write-Verbose -Message "Temp now equal to [$($temp -join ',')]"
                    }
                }
                if ($IncludeInput) {
                    New-Object -TypeName psobject -Property ([ordered] @{
                            Right       = $curRights
                            RightHex    = ('0x{0:x6}' -f $curRights)
                            RightString = ( $temp -join ',' )
                        })
                } else {
                    Write-Output -InputObject ( $temp -join ',' )
                }
            }
        }

    }

    end {
        Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]"
    }
} # EndFunction ConvertFrom-FsRight