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 触发器）时，将删除原始触发器属性。 但是，如果更改触发器的值而非其类型（例如在每周触发器中更改日期），则仅更改指定的属性。 保留原始作业触发器的所有其他属性。

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

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

示例 2：更改作业触发器类型

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 获取 Inventory 计划作业的作业触发器。 输出显示作业有两个触发器，一个是每日触发器，一个 是 AtStartup 触发器。

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

示例 3：更改远程作业触发器上的用户

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。

示例 4：更改许多作业触发器中的一个

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

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

参数

-At

-AtLogOn

-AtStartup

-Daily

-DaysInterval

-DaysOfWeek

-InputObject

-Once

-PassThru

-RandomDelay

-RepeatIndefinitely

-RepetitionDuration

-RepetitionInterval

-User

-Weekly

-WeeksInterval

输入

ScheduledJobTrigger

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

输出

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

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

备注

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

相关链接

• 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