MSP Programs & Scripts Code

#
# Get-QUserInfo - Get Idle and Logon time of users on list of computers 
#
# reddit user: Lee Dailey @ https://www.reddit.com/user/Lee_Dailey/
#
function Get-QUserInfo
    {
    [CmdletBinding()]
    Param (
        [Parameter ()]
            [string[]]
            $ComputerName = $env:COMPUTERNAME
        )

    begin {
        $Header = 'UserName','SessionName','ID','State','IdleTime','LogonTime'
        $No_Connection = '-- No Connection --'
        }
         
    process {
        foreach ($CN_Item in $ComputerName) {
            if (Test-Connection -ComputerName $CN_Item -Count 1 -Quiet) {
                quser /server:$CN_Item |
                    Select-Object -Skip 1 |
                    ForEach-Object {($_ -replace '\s{2,}', ',').Trim()} |
                    ConvertFrom-Csv -Header $Header |
                    ForEach-Object {
                        if ($_.IdleTime -eq 'none') {
                            $IdleTime = $Null
                          } else {
                            $IdleTime = [timespan]$_.IdleTime
                        }
                        [PSCustomObject]@{
                            ComputerName = $CN_Item
                            UserName = $_.UserName
                            SessionName = $_.SessionName
                            ID = $_.ID
                            State = $_.State
                            IdleTime = $IdleTime
                            LogonTime = [datetime]$_.LogonTime
                        }
                        # Write-Output "object: " $_ | Get-Member | Format-Table
                    }                
              } else {
                [PSCustomObject]@{
                    ComputerName = $CN_Item
                    UserName = $No_Connection
                    SessionName = $No_Connection
                    ID = $No_Connection
                    State = $No_Connection
                    IdleTime = $No_Connection
                    LogonTime = $No_Connection
                }                
            }
        } # end >> foreach ($CN_Item in $ComputerName)
    } # end >> process {}

    end {}

} # end >> function Get-QUserInfo
#
# example usage:
#
Get-QUserInfo -ComputerName localhost

Get-QUserInfo -ComputerName notARealHost, localHost