Set-JobTrigger

Set-JobTrigger
    [-InputObject] <ScheduledJobTrigger[]>
    [-DaysInterval <Int32>]
    [-WeeksInterval <Int32>]
    [-RandomDelay <TimeSpan>]
    [-At <DateTime>]
    [-User <String>]
    [-DaysOfWeek <DayOfWeek[]>]
    [-AtStartup]
    [-AtLogOn]
    [-Once]
    [-RepetitionInterval <TimeSpan>]
    [-RepetitionDuration <TimeSpan>]
    [-RepeatIndefinitely]
    [-Daily]
    [-Weekly]
    [-PassThru]
    [<CommonParameters>]

Set-JobTrigger cmdlet 更改计划作业的作业触发器的属性。 可以使用它更改作业启动的时间或频率，或者从基于时间的计划更改为由登录或启动触发的计划。

作业触发器定义用于启动计划作业的定期计划或条件。 虽然作业触发器未保存到磁盘，但可以更改已保存到磁盘的计划作业的作业触发器。

若要更改计划作业的作业触发器，请首先使用 Get-JobTrigger cmdlet 获取计划作业的作业触发器。 然后，通过管道将触发器传递给 Set-JobTrigger 或将触发器保存在变量中，并使用 Set-JobTrigger cmdlet 的 InputObject 参数来标识触发器。 使用 set-JobTrigger 的剩余参数更改作业触发器。

更改作业触发器的类型（例如将作业触发器从每日或每周触发器更改为 AtLogon 触发器），将删除原始触发器属性。 但是，如果更改触发器的值，但不更改其类型，例如更改每周触发器中的天数，则只会更改指定的属性。 保留原始作业触发器的所有其他属性。

Set-JobTrigger 是 PSScheduledJob 模块中包含的作业计划 cmdlet 集合之一。

有关计划作业的详细信息，请参阅 PSScheduledJob 模块中的“关于”主题。 导入 PSScheduledJob 模块，然后键入：Get-Help about_Scheduled* 或查看about_Scheduled_Jobs。

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

PS C:\> Get-JobTrigger -Name "DeployPackage"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Saturday}   True

The second command uses the Get-JobTrigger cmdlet to get the job trigger of the DeployPackage scheduled job. A pipeline operator (|) sends the trigger to the **Set-JobTrigger** cmdlet, which changes the job trigger so that it starts the DeployPackage job on Wednesdays and Sundays. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> Get-JobTrigger -Name "DeployPackage" | Set-JobTrigger -DaysOfWeek "Wednesday", "Sunday" -Passthru
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Sunday}     True

此示例演示如何更改每周作业触发器中的天数。

第一个命令使用 Get-JobTrigger cmdlet 来获取 DeployPackage 计划作业的作业触发器。 该输出显示触发器在星期三和星期六的午夜启动作业。

此命令不是必需的；包含它只是为了显示触发器更改的效果。

PS C:\> Get-JobTrigger -Name "Inventory"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          AtStartup                                                      True

The second command uses the **Get-JobTrigger** cmdlet to get the *AtStartup* job trigger of the Inventory job. The command uses the *TriggerID* parameter to identify the job trigger. A pipeline operator (|) sends the job trigger to the **Set-JobTrigger** cmdlet, which changes it to a weekly job trigger that runs every four weeks on Monday at midnight. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> Get-JobTrigger -Name "Inventory" -TriggerID 2 | Set-JobTrigger -Weekly -WeeksInterval 4 -DaysOfWeek Monday -At "12:00 AM"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          Weekly          10/31/2011 12:00:00 AM {Monday}                True

此示例演示如何更改启动作业的作业触发器的类型。 此示例中的命令将 AtStartup 作业触发器替换为每周触发器。

第一个命令使用 Get-JobTrigger cmdlet 获取清单计划作业的作业触发器。 该输出显示该作业有两个触发器，即每日触发器和 AtStartup 触发器。

此命令不是必需的；包含它只是为了显示触发器更改的效果。

PS C:\> Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.User} | Set-JobTrigger -User "Domain01/Admin02"}

此命令更改在 Server01 计算机上计划作业的所有 AtLogon 作业触发器中的用户。

该命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行命令。

远程命令以获取计算机上的所有计划作业的 Get-ScheduledJob 命令开头。 计划作业通过管道传递给 Get-JobTrigger cmdlet，该 cmdlet 获取计划作业的作业触发器。 每个作业触发器都包含一个包含计划作业的 JobDefinition 属性，因此即使更改了计划作业，触发器也保持与计划作业的关联。

作业触发器通过管道传输到 Where-Object cmdlet，该 cmdlet 获取具有 User 属性的作业触发器。 选定的作业触发器通过管道传递给 Set-JobTrigger cmdlet，该 cmdlet 会将用户更改为 Domain01\Admin02。

PS C:\> Get-JobTrigger -Name "SecurityCheck"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           4/24/2013 3:00:00 AM                           True
2          Weekly          4/24/2013 4:00:00 PM   {Sunday}                True
3          Once            4/24/2013 4:00:00 PM                           True

The second command uses the **TriggerID** parameter of the **Get-JobTrigger** cmdlet to get the *Once* trigger of the SecurityCheck scheduled job. The command pipes the trigger to the Format-List cmdlet, which displays all of the properties of the *Once* job trigger.The output shows that the trigger starts the job once every hour (RepetitionInterval = 1 hour) for one day (RepetitionDuration = 1 day).
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *
At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:00:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

The third command changes the repetition interval of the job trigger from one hour to 90 minutes. The command does not return any output.
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerId 3 | Set-JobTrigger -RepetitionInterval (New-TimeSpan -Minutes 90)

The fourth command displays the effect of the change.The output shows that the trigger starts the job once every 90 minutes (RepetitionInterval = 1 hour, 30 minutes) for one day (RepetitionDuration = 1 day).
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *
At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:30:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

此示例中的命令将 SecurityCheck 计划作业的 一次作业触发器的重复间隔从每 60 分钟更改为每 90 分钟一次。 SecurityCheck 计划作业具有三个作业触发器，因此命令使用 Get-JobTrigger cmdlet 的 TriggerId 参数来标识正在更改的作业触发器。

第一个命令使用 Get-JobTrigger cmdlet 获取 SecurityCheck 计划作业的所有作业触发器。 显示任务触发器 ID 的输出显示 Once 任务触发器的 ID 为 3。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

您可以通过管道将多个作业触发器传递给 Set-JobTrigger。

使用 Passthru 参数时，Set-JobTrigger 返回已更改的作业触发器。 否则，此 cmdlet 不会生成任何输出。

• 作业触发器具有 JobDefintion 属性，用于将其与计划的作业相关联。 更改计划作业的作业触发器时，作业将发生更改。 无需使用 Set-ScheduledJob 命令将更改的触发器应用于计划作业。