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 Set-JobTrigger 參數 InputObject 參數來識別觸發程式。 使用 set-JobTrigger 的其餘 參數來變更作業觸發程式。

當您變更作業觸發程式的類型時，例如將作業觸發程式從每日或每周觸發程式變更為 AtLogon 觸發程式，則會刪除原始觸發程序屬性。 不過，如果您變更觸發程式的值，但不是其類型，例如變更每周觸發程式中的天數，則只會變更您指定的屬性。 原始作業觸發程式的其他所有屬性都會保留。

Set-JobTrigger 是 Windows PowerShell 隨附的 PSScheduledJob 模組中其中一個作業排程 Cmdlet 集合。

如需排程工作的詳細資訊，請參閱 PSScheduledJob 模組中的 About 主題。 匯入 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 命令，即可將變更的觸發程式套用至排程的工作。