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 或将其保存在某个变量中，并且使用 cmdlet 的 InputObject 参数来标识触发器。Set-JobTrigger 使用 Set-JobTrigger 的其余参数来更改作业触发器。

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

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

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

此 cmdlet 已在 Windows PowerShell 3.0 中引入。

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

Get-JobTrigger -Name "DeployPackage"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Saturday}   True

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 计划作业的作业触发器。 该输出显示触发器在星期三和星期六的午夜启动作业。

第二个命令使用 Get-JobTrigger cmdlet 获取 DeployPackage 计划作业的作业触发器。 管道运算符 (|) 将该触发器发送到 Set-JobTrigger cmdlet，此 cmdlet 将更改该作业触发器，以便可在星期三和星期天启动 DeployPackage 作业。 该命令使用 PassThru 参数在更改后返回触发器。

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

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

Get-JobTrigger -Name "Inventory"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          AtStartup                                                      True

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

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

第二个命令使用 Get-JobTrigger cmdlet 获取 作业的 AtStartup 作业触发器。Inventory 该命令使用 TriggerId 参数来标识作业触发器。 管道运算符 (|) 将该作业触发器发送到 Set-JobTrigger cmdlet，此 cmdlet 将该触发器更改为在每四个星期的星期一午夜运行的每周作业触发器。 该命令使用 PassThru 参数在更改后返回触发器。

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

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。

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

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

Get-JobTrigger -Name "SecurityCheck" -TriggerId 3 |
    Set-JobTrigger -RepetitionInterval (New-TimeSpan -Minutes 90)
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

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

第一个命令使用 Get-JobTrigger cmdlet 获取 SecurityCheck 计划作业的所有作业触发器。 显示作业触发器 ID 的输出显示 一旦 作业触发器具有 ID3。

第二个命令使用 cmdlet 的 Get-JobTrigger 参数 SecurityCheck 触发器一次。 此命令通过管道将触发器发送给 Format-List cmdlet，此 cmdlet 显示 Once 作业触发器的所有属性。 该输出显示，触发器每 4 小时启动作业一次（RepetitionInterval 为 1 小时）且持续时间为一天（RepetitionDuration 为 1 天）。

第三个命令将作业触发器的重复间隔时间从 1 小时更改为 90 分钟。 该命令不返回任何输出。

第四个命令显示变更的影响。该输出显示，触发器每 90 分钟启动作业一次（RepetitionInterval 为 1 小时 30 分钟）且持续时间为一天（RepetitionDuration 为 1 天）。

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

可以通过管道将作业触发器传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

当使用 PassThru 参数时，此 cmdlet 返回它已更改的作业触发器。

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