< Back
Get-ScheduledJob
Post
NAME Get-ScheduledJob
SYNOPSIS
Gets scheduled jobs on the local computer.
SYNTAX
Get-ScheduledJob [[-Id] <Int32[]>] [<CommonParameters>]
Get-ScheduledJob [-Name] <String[]> [<CommonParameters>]
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 was 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.
Required? false
Position? 0
Default value None
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.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
You cannot pipe input to Get-ScheduledJob .
OUTPUTS
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.
Example 1: Get all scheduled jobs
PS C:\\>Get-ScheduledJob
This command gets all scheduled jobs on the local computer.
Example 2: Get scheduled jobs by name
PS C:\\>Get-ScheduledJob -Name *Backup*, *Archive*
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.
Example 3: Get scheduled jobs on remote computers
PS C:\\>Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}
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.
Example 4: Pipe scheduled jobs to other cmdlets
PS C:\\>Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821686
Add-JobTrigger
Disable-JobTrigger
Disable-ScheduledJob
Enable-JobTrigger
Enable-ScheduledJob
Get-JobTrigger
Get-ScheduledJob
Get-ScheduledJobOption
New-JobTrigger
New-ScheduledJobOption
Register-ScheduledJob
Remove-JobTrigger
Set-JobTrigger
Set-ScheduledJob
Set-ScheduledJobOption
Unregister-ScheduledJob
SYNOPSIS
Gets scheduled jobs on the local computer.
SYNTAX
Get-ScheduledJob [[-Id] <Int32[]>] [<CommonParameters>]
Get-ScheduledJob [-Name] <String[]> [<CommonParameters>]
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 was 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.
Required? false
Position? 0
Default value None
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.
Required? true
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
You cannot pipe input to Get-ScheduledJob .
OUTPUTS
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.
Example 1: Get all scheduled jobs
PS C:\\>Get-ScheduledJob
This command gets all scheduled jobs on the local computer.
Example 2: Get scheduled jobs by name
PS C:\\>Get-ScheduledJob -Name *Backup*, *Archive*
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.
Example 3: Get scheduled jobs on remote computers
PS C:\\>Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}
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.
Example 4: Pipe scheduled jobs to other cmdlets
PS C:\\>Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821686
Add-JobTrigger
Disable-JobTrigger
Disable-ScheduledJob
Enable-JobTrigger
Enable-ScheduledJob
Get-JobTrigger
Get-ScheduledJob
Get-ScheduledJobOption
New-JobTrigger
New-ScheduledJobOption
Register-ScheduledJob
Remove-JobTrigger
Set-JobTrigger
Set-ScheduledJob
Set-ScheduledJobOption
Unregister-ScheduledJob