Get-KNOWNFOLDERID.psm1

function Get-KNOWNFOLDERID {
    <#
    .SYNOPSIS
        Lists KNOWNFOLDERID data.
	.DESCRIPTION
		Reads the registry and outputs a PSCustomObject and contains the KNOWNFOLDERID data.
	.PARAMETER KNOWNFOLDERID

        Limits the output to the provided KNOWNFOLDERID.
    .OUTPUTS
        PSCustomObject
	.EXAMPLE
        Get-KNOWNFOLDERID

        Outputs all KNOWNFOLDERID data.
	.EXAMPLE
        Get-KNOWNFOLDERID -KNOWNFOLDERID '{F38BF404-1D43-42F2-9305-67DE0B28FC23}'

        Outputs the KNOWNFOLDERID data for '{F38BF404-1D43-42F2-9305-67DE0B28FC23}'.
	.NOTES
    #>
    [CmdletBinding()]
    param (
        [string]$Id = '*'
    )

    $Path = "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\FolderDescriptions\$($Id)"
    
    Get-ItemProperty -Path Registry::$Path | Sort-object -Property Name | ForEach-Object {
        $Parent = $null
        if ( $_.ParentFolder ) {
            $Parent = Get-KNOWNFOLDERID -Id "$($_.ParentFolder)"
        }
        $Properties = [ordered]@{
            KNOWNFOLDERID = $_.PSChildName.ToUpper()
            Name          = $_.Name
            ParentFolder  = $_.ParentFolder
            RelativePath  = $_.RelativePath
            Parent        = $Parent
        }
        [PSCustomObject]$Properties
    }
}