Private/ConvertTo-QuserObject.ps1

<#
    .Synopsis

        This processes the STDOUT from `quser.exe` and returns an object.

    .Parameter QuserOutput

        A hashtable of the target server and the STDOUT (Result) as returned by `quser.exe`.
#>

function ConvertTo-QuserObject {
    [CmdletBinding()]
    [OutputType([PSObject])]
    Param(
        [Parameter(
            ValueFromPipeline = $true,
            Mandatory = $true
        )]
        [hashtable]
        $QuserOutput
    )

    begin {
        
        Write-Debug "[QuserObject ConvertTo-QuserObject] Begin Bound Parameters: $($MyInvocation.BoundParameters | ConvertTo-Json)"
        Write-Debug "[QuserObject ConvertTo-QuserObject] Begin Unbound Parameters: $($MyInvocation.UnboundParameters | ConvertTo-Json)"
    }

    process {
        Write-Debug "[QuserObject ConvertTo-QuserObject] Process Bound Parameters: $($MyInvocation.BoundParameters | ConvertTo-Json)"
        Write-Debug "[QuserObject ConvertTo-QuserObject] Process Unbound Parameters: $($MyInvocation.UnboundParameters | ConvertTo-Json)"

        Write-Debug "[QuserObject ConvertTo-QuserObject] Culture ($(Get-Culture)) DateTime Format: $((Get-Culture).DateTimeFormat.ShortDatePattern)"
        if ((Get-Culture).Parent.Name -eq 'es') {
            Write-Debug "[QuserObject ConvertTo-QuserObject] Culture Adjustments: ${script:Culture}"
            $QuserOutput.Result[0] = $QuserOutput.Result[0].Replace('.', ' ')
        }

        Write-Debug "[QuserObject ConvertTo-QuserObject] QuserOutput.Result:`n$($QuserOutput.Result | Out-String)"
        
        $quserRows = $QuserOutput.Result
        $headerRow = $quserRows[0]
        Write-Debug "[QuserObject ConvertTo-QuserObject] Header:`n$($headerRow | Out-String)"
        
        $match = [regex]::Match($headerRow, '(\s{2,})')
        $usernameSize = @(
            0,
            ($match.Index + $match.Length)
        )
        Write-Debug "[QuserObject ConvertTo-QuserObject] UserName Size: ${usernameSize}"
        
        foreach ($row in $quserRows[1..$quserRows.GetUpperBound(0)]) {
            Write-Debug "[QuserObject ConvertTo-QuserObject] Process Row [$($row.GetType())]: ${row}"
            
            $rowUserName = $row.Substring($usernameSize[0], $usernameSize[1])
            Write-Debug "[QuserObject ConvertTo-QuserObject] Row UserName: $rowUserName"
            
            $restOfRow = $row.Substring($usernameSize[1]).Trim()
            Write-Debug "[QuserObject ConvertTo-QuserObject] Rest of Row [$($row.GetType())]: ${restOfRow}"

            [Collections.ArrayList] $rowSplit = $restOfRow -split '\s{2,}'
            Write-Debug "[QuserObject ConvertTo-QuserObject] Process RowSplit [$($rowSplit.GetType())]:`n$($rowSplit | Out-String)"


            if ($rowSplit.Count -eq 4) {
                # SessionName appears to be blank
                $rowSplit.Insert(0, '')
                Write-Debug "[QuserObject ConvertTo-QuserObject] Process RowSplit FIXED [$($rowSplit.GetType())]:`n$($rowSplit | Out-String)"
            }
            
            $getQuserIdleTime = @{
                QuserIdleTime = $rowSplit[3]
                AsDateTime    = $script:IdleStartTime
            }
            Write-Debug "[QuserObject ConvertTo-QuserObject] QuserIdleTime Splat:`n$($getQuserIdleTime | Out-String)"
            
            $quser = @{
                IsCurrentSession = $rowUserName.StartsWith('>')
                UserName = $rowUserName.TrimStart('>').Trim()
                SessionName = $rowSplit[0]
                Id = $rowSplit[1] -as [int]
                State = $rowSplit[2]
                IdleTime = (Get-QuserIdleTime @getQuserIdleTime)
                LogonTime = (Get-Date $rowSplit[4])
                Server = $QuserOutput.Server
            }
            Write-Debug "[QuserObject ConvertTo-QuserObject] Row Parsed:`n$($quser | Out-String)"
            
            $quserObject = New-Object PSObject -Property $quser
            Write-Debug "[QuserObject ConvertTo-QuserObject] QuserObject:`n$($quserObject | Out-String)"
            
            $quserObject.PSTypeNames.Insert(0, 'QuserObject')
            Write-Debug "[QuserObject ConvertTo-QuserObject] QuserObject Types:`n$($quserObject.PSTypeNames | Out-String)"

            Write-Output $quserObject
        }
    }
}