Get-ScheduledTask (PowerShell 3.0+)

Get the task definition object of a scheduled task that is registered on the local computer.

Syntax
      Get-ScheduledTask [[-TaskName] String[]] [[-TaskPath] String[]]
         [-CimSession CimSession[]] [-ThrottleLimit Int32] [-AsJob] [CommonParameters]

Key
   -AsJob
       Run the cmdlet as a background job.
       Use this parameter to run commands that take a long time to complete.

  -CimSession

       Run the cmdlet in a remote session or on a remote computer.
       Enter a computer name or a session object, such as the output of a New-CimSession or
       Get-CimSession cmdlet. The default is the current session on the local computer.

   -TaskName
       An array of one or more scheduled task names.
       Use "*" for a wildcard query.

 

Examples

Get a scheduled task definition object:

PS C:\> Get-ScheduledTask -TaskName "SystemScan"

Get an array of scheduled task definition objects:

PS C:\> Get-ScheduledTask -TaskPath "\UpdateTasks\*"

Get a list of scheduled tasks that will wake the machine to run:

PS C:\> Get-ScheduledTask | where{$_.settings.waketorun} |FT -autosize

“When someone does a small task beautifully, their whole environment is affected by it” ~ Jerry Seinfeld

Related PowerShell Cmdlets

Scheduler cmdlets - Get/Set scheduled jobs.
Get-ScheduledJob - Get scheduled jobs on the local computer.
Enable-ScheduledJob - Enable a scheduled job.


 
Copyright © 1999-2026 SS64.com
Some rights reserved