Get-JobTrigger
获取计划作业的作业触发器。
语法
Get-JobTrigger
[[-TriggerId] <Int32[]>]
[-InputObject] <ScheduledJobDefinition>
[<CommonParameters>]
Get-JobTrigger
[[-TriggerId] <Int32[]>]
[-Name] <String>
[<CommonParameters>]
Get-JobTrigger
[[-TriggerId] <Int32[]>]
[-Id] <Int32>
[<CommonParameters>]
说明
Get-JobTrigger cmdlet 可获取计划作业的作业触发器。 你可以使用此命令检查作业触发器或通过管道将其传递给其他 cmdlet。
作业触发器定义用于启动计划作业的定期计划或条件。 不会单独将作业触发器保存到磁盘,因为它们是计划作业的一部分。 若要获取作业触发器,请指定该触发器启动的计划作业。
使用 Get-JobTrigger cmdlet 的参数来标识计划作业。 可以通过计划作业的名称或标识号来标识计划作业,也可以通过将 ScheduledJob 对象(例如 Get-ScheduledJob cmdlet 返回的对象)输入或管道到 Get-JobTrigger 来标识这些对象。
Get-JobTrigger 是 PSScheduledJob 模块(包含在 Windows PowerShell 中)中的一系列作业计划 cmdlet 之一。
有关计划作业的详细信息,请参阅 PSScheduledJob 模块中的“关于”主题。
导入 PSScheduledJob 模块,然后键入:Get-Help about_Scheduled*
,或参阅 about_Scheduled_Jobs。
此 cmdlet 是在 Windows PowerShell 3.0 中引入的。
示例
示例 1:按计划作业名称获取作业触发器
PS C:\> Get-JobTrigger -Name "BackupJob"
命令使用 Get-JobTrigger 的 Name 参数获取 BackupJob 计划作业的作业触发器。
示例 2:按 ID 获取作业触发器
The first command uses the Get-ScheduledJob cmdlet to display the scheduled jobs on the local computer. The display includes the IDs of the scheduled jobs.
PS C:\> Get-ScheduledJob
Id Name Triggers Command Enabled
-- ---- -------- ------- -------
1 ArchiveProjects {1} \\Server\Share\Archive-Projects.ps1 True
2 Backup {1,2} \\Server\Share\Run-Backup.ps1 True
3 Test-HelpFiles {1} \\Server\Share\Test-HelpFiles.ps1 True
4 TestJob {} \\Server\Share\Run-AllTests.ps1 True
The second command uses the **Get-JobTrigger** cmdlet to get the job trigger for the Test-HelpFiles job (ID = 3)
PS C:\> Get-JobTrigger -ID 3
该示例使用 Get-JobTrigger 的 ID 参数来获取计划作业的作业触发器。
示例 3:通过管道传递作业以获取作业触发器
PS C:\> Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger
此命令获取名称中包含 Backup 或 Archive 的所有作业的作业触发器。
示例 4:获取远程计算机上某个作业的作业触发器
PS C:\> Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }
此命令获取远程计算机上某个计划作业的两个作业触发器之一。
该命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行命令。 它使用 Get-ScheduledJob cmdlet 获取 Backup 计划作业,该作业将通过管道传递给 Get-JobTrigger cmdlet。 它使用 TriggerID 参数仅获取第二个触发器。
示例 5:获取所有作业触发器
PS C:\> Get-ScheduledJob | Get-JobTrigger | Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize
Id Frequency At DaysOfWeek Enabled ScheduledJob
-- --------- -- ---------- ------- ------------
1 Weekly 9/28/2011 3:00:00 AM {Monday} True Backup
1 Daily 9/27/2011 11:00:00 PM True Test-HelpFiles
此命令获取本地计算机上的所有计划作业的所有作业触发器。
此命令使用 Get-ScheduledJob 获取本地计算机上的计划作业,并通过管道将这些作业传递给 Get-JobTrigger,它将获取每个计划作业的作业触发器(如果有)。
若要将计划作业的名称添加到作业触发器显示,该命令使用 Format-Table cmdlet 的计算属性功能。 除了默认显示的作业触发器属性外,命令还会创建显示计划作业名称的新 ScheduledJob 属性。
示例 6:获取计划作业的作业触发器属性
The command uses the Get-ScheduledJob cmdlet to get the Test-HelpFiles scheduled job. Then it uses the dot method (.) to get the JobTriggers property of the Test-HelpFiles scheduled job.
PS C:\> (Get-ScheduledJob Test-HelpFiles).JobTriggers
The second command uses the Get-ScheduledJob cmdlet to get all scheduled jobs on the local computer. It uses the ForEach-Object cmdlet to get the value of the JobTrigger property of each scheduled job.
PS C:\> Get-ScheduledJob | foreach {$_.JobTriggers}
计划作业的作业触发器存储在该作业的 JobTriggers 属性中。 此示例演示了使用 Get-JobTrigger cmdlet 获取作业触发器的替代方法。 结果与使用 Get-JobTrigger cmdlet 相同,因此这两项技术可以互换使用。
示例 7:比较作业触发器
The first command gets the job trigger of the ArchiveProjects scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T1 variable and displays it at the command line.
PS C:\> Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable T1
Id Frequency Time DaysOfWeek Enabled
-- --------- ---- ---------- -------
0 Daily 9/26/2011 3:00:00 AM True
The second command gets the job trigger of the Test-HelpFiles scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T2 variable and displays it at the command line.
PS C:\> Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable T2
Id Frequency Time DaysOfWeek Enabled
-- --------- ---- ---------- -------
0 Daily 9/26/2011 3:00:00 AM True
The third command compares the job triggers in the $t1 and $t2 variables. It uses the Get-Member cmdlet to get the properties of the job trigger in the $t1 variable. It pipes the properties to the ForEach-Object cmdlet, which compares each property to the properties of the job trigger in the $t2 variable by name. The command then pipes the differing properties to the Format-List cmdlet, which displays them in a list.The output indicates that, although the job triggers appear to be the same, the HelpFiles job trigger includes a random delay of three (3) minutes.
PS C:\> $T1 | Get-Member -Type Property | ForEach-Object { Compare-Object $T1 $T2 -Property $_.Name}
RandomDelay SideIndicator
----------- -------------
00:00:00 =>
00:03:00 <=
此示例显示了如何比较两个计划作业的作业触发器。
参数
-Id
指定计划作业的标识号。 Get-JobTrigger 可获取指定的计划作业的作业触发器。
若要获取本地计算机或远程计算机上的计划作业的标识号,请使用 Get-ScheduledJob cmdlet。
Type: | Int32 |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定计划作业。 请输入包含 ScheduledJob 对象的变量,或者键入获取 ScheduledJob 对象的命令或表达式,例如 Get-ScheduledJob 命令。 还可以通过管道将 ScheduledJob 对象传递给 Get-JobTrigger。
Type: | ScheduledJobDefinition |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定计划作业的名称。 Get-JobTrigger 可获取指定的计划作业的作业触发器。 支持通配符。
若要获取本地计算机或远程计算机上的计划作业的名称,请使用 Get-ScheduledJob cmdlet。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TriggerId
获取指定的作业触发器。 输入计划作业中一个或多个作业触发器的触发器 ID。 在 Name、ID 或 InputObject 参数指定的计划作业有多个作业触发器时使用此参数。
Type: | Int32[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将计划作业从 Get-ScheduledJob 传递到 Get-JobTrigger。
输出
相关链接
- about_Scheduled_Jobs
- 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