Get-UserSession

SYNOPSIS

PowerShell wrapper for "query user" command which also offers resolving the Display Name of users and gathering of user session process information

DESCRIPTION

PowerShell wrapper for "query user" command which also offers resolving the Display Name of users and gathering of user session process information

PARAMETERS

-ComputerName

The computer name(s) for which you want to gather user session information

-ResolveDisplayName

Used to determine whether or not to attempt resolving the Display Name for each user

-IncludeProcessInfo

Used to determine whether or not to gather process information for each user session

-Credential

Used to pass into the Invoke-Command function for gathering process information. This is exposed so that you have flexibility for connectivity.

-Port

Used to pass into the Invoke-Command function for gathering process information. This is exposed so that you have flexibility for connectivity.

-UseSSL

Used to pass into the Invoke-Command function for gathering process information. This is exposed so that you have flexibility for connectivity.

-Authentication

Used to pass into the Invoke-Command function for gathering process information. This is exposed so that you have flexibility for connectivity.

-SessionOption

Used to pass into the Invoke-Command function for gathering process information. This is exposed so that you have flexibility for connectivity.

-BatchSize

Used for the runspace pooling that is utilized for more efficient parallel processing. This is exposed so that you have flexibility for runspace behavior. Default value is calculated from: [int]$env:NUMBER_OF_PROCESSORS + 1

-ApartmentState

Used for the runspace pooling that is utilized for more efficient parallel processing. This is exposed so that you have flexibility for runspace behavior. Default value is 'STA'

-ShowProgress

Used to determine whether or not to display a progress bar as the runspace pool is processed

EXAMPLE 1

PS C:\>Get-UserSession

Gets the current user sessions from the local machine

EXAMPLE 2

PS C:\>Get-UserSession -ComputerName (Get-ADComputer -Filter *).DnsHostname -ShowProgress -Verbose | Format-Table -Autosize

Gets the user sessions from all Active Directory computers while showing a progress bar and displaying verbose information

EXAMPLE 3

PS C:\>'ComputerA', 'ComputerB' | Get-UserSession -ResolveDisplayName | Format-Table -Autosize

Gets the user sessions from ComputerA and ComputerB and resolves the Display Name of the users for the output