Export (0) Print
Expand All

Get-ScheduledJob

Updated: May 7, 2014

Applies To: Windows PowerShell 4.0

Get-ScheduledJob

Gets scheduled jobs on the local computer.

Syntax

Parameter Set: DefinitionId
Get-ScheduledJob [[-Id] <Int32[]> ] [ <CommonParameters>]

Parameter Set: DefinitionName
Get-ScheduledJob [-Name] <String[]> [ <CommonParameters>]




Detailed Description

The Get-ScheduledJob cmdlet gets scheduled jobs on the local computer. Get-ScheduledJob gets only scheduled jobs that are created by the current user using the Register-ScheduledJob cmdlet.

Although jobs that are created by using the Register-ScheduledJob cmdlet appear in Task Scheduler, Get-ScheduledJob gets only scheduled jobs. It does not get scheduled tasks created in Task Scheduler.

Without parameters, Get-ScheduledJob gets all scheduled jobs on the computer. You can use the parameters of Get-ScheduledJob to get scheduled jobs by ID or name and examine them or pipe them to other cmdlets.

Get-ScheduledJob is one of a collection of job scheduling cmdlets in the PSScheduledJob module that is included in Windows PowerShell.

For more information about Scheduled Jobs, see the About topics in the PSScheduledJob module. Import the PSScheduledJob module and then type: Get-Help about_Scheduled* or see about_Scheduled_Jobs.

This cmdlet is introduced in Windows PowerShell 3.0.

Parameters

-Id<Int32[]>

Gets only the scheduled jobs with the specified identification number (ID). Enter one or more IDs of scheduled jobs on the computer. By default, Get-ScheduledJob gets all scheduled jobs on the computer.


Aliases

none

Required?

false

Position?

1

Default Value

All jobs

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String[]>

Gets only the scheduled jobs with the specified names. Enter one or more names of scheduled jobs on the computer. Wildcards are supported. By default, Get-ScheduledJob gets all scheduled jobs on the computer.


Aliases

none

Required?

true

Position?

1

Default Value

All jobs

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

    You cannot pipe input to Get-ScheduledJob.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Notes

  • Each scheduled job is saved in a subdirectory of the $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory on the local computer. The subdirectory is named for the scheduled job and contains the XML file for the scheduled job and records of its execution history. For more information about scheduled jobs on disk, see about_Scheduled_Jobs_Advanced.

  • Scheduled jobs that you create in Windows PowerShell appear in Task Scheduler in the Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs folder. You can use Task Scheduler to view and edit the scheduled job.

  • You can use Task Scheduler, the SchTasks.exe command-line tool, and the Task Scheduler cmdlets to manage scheduled jobs that you create with the Scheduled Job cmdlets. However, you cannot use the Scheduled Job cmdlets to manage tasks that you create in Task Scheduler.

Examples

Example 1: Get all scheduled jobs

This command gets all scheduled jobs on the local computer.


PS C:\> Get-ScheduledJob

Example 2: Get scheduled jobs by name

This command gets all scheduled jobs on the computer that have names that include "Backup" or "Archive". This command format lets you search for particular jobs.


PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

Example 3: Get scheduled jobs on remote computers

This command gets all scheduled jobs on the computers that are listed in the Servers.txt file. The command uses the Invoke-Command cmdlet to run a Get-ScheduleJob command on each computer.


PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Example 4: Pipe scheduled jobs to other cmdlets

This command gets the job triggers of the DailyBackup and WeeklyBackup scheduled jobs. It uses the Get-ScheduledJob cmdlet to get the scheduled jobs and the Get-JobTrigger cmdlet to get the job triggers of the scheduled jobs.


PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Related topics



Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft