Functions/Get-ScheduledTaskUser.ps1
|
function Get-ScheduledTaskUser { <# .SYNOPSIS Get a list of scheduled tasks and the user context that they run under. By default excluded system tasks .DESCRIPTION Get a list of scheduled tasks and the user context that they run under. By default excluded system tasks .PARAMETER ComputerName An array of computer names. Defaults to $env:COMPUTERNAME. Aliased to 'CN', 'Server' .PARAMETER UserName A -like search string to compare process username context. Defaults to '*' .PARAMETER IncludeSystem Switch to include the system scheduled tasks. Aliased to 'IS' .PARAMETER IncludeInteractive Switch to include interactive only tasks. Aliased to 'II' .NOTES Unless the -IncludeSystem switch is specified the following will be excluded from the output: 'Administrator', 'Administrators', 'Authenticated Users', 'Everyone', 'INTERACTIVE', 'LOCAL SERVICE', 'NETWORK SERVICE', 'Run As User', 'SYSTEM', 'Users' #> [CmdletBinding()] [OutputType('psobject')] param ( [Alias('CN', 'Server')] [string[]] $ComputerName = $env:COMPUTERNAME, [string] $UserName = '*', [Alias('IS')] [switch] $IncludeSystem, [Alias('II')] [switch] $IncludeInteractive ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" Write-Verbose -Message "ComputerName [$($ComputerName -join ', ')]" Write-Verbose -Message "IncludeSystem [$IncludeSystem], IncludeInteractive [$IncludeInteractive], UserName [$UserName]" $System = @( 'Administrator', 'Administrators', 'Authenticated Users', 'Everyone', 'INTERACTIVE', 'LOCAL SERVICE', 'NETWORK SERVICE', 'Run As User', 'SYSTEM', 'Users' ) $Task = @() } process { foreach ($curComputer in $ComputerName) { Write-Verbose -Message "Processing [$curComputer]" $TmpResult = (schtasks.exe /query /s $curComputer /V /FO CSV) 2>$null if ($LastExitCode -eq 0) { $Task += $TmpResult | ConvertFrom-Csv } else { Write-Error -Message "Either computer [$curComputer] is not up, or you don't have permission to run schtasks.exe against it." } } } end { $Task = $Task | Where-Object { $_.'Run As User' -like $UserName } if (-not $IncludeSystem) { Write-Verbose -Message 'Excluding system tasks' $Task = $Task | Where-Object { $_.'Run As User' -notin $System -and $null -ne $_.'Run As User' } } if (-not $IncludeInteractive) { $Task = $Task | Where-Object { $_.'Logon Mode' -ne 'Interactive Only' } } $Task | Where-Object { $_.Hostname -ne 'Hostname' } | Select-Object -Property @{Name = 'ComputerName'; Expr = { $_.HostName } }, TaskName, Status, @{Name = 'RunAsUser'; Expr = { $_.'Run As User' } }, @{Name='LogonMode'; Expr = { $_.'Logon Mode'}} Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |