about_Scheduled_Jobs_Basics

發行項
03/19/2024

簡短描述

說明如何建立和管理排程的工作。

詳細描述

本文件說明如何執行建立和管理排程工作的基本工作。如需更多進階工作的詳細資訊，請參閱 about_Scheduled_Jobs_Advanced。

如需 PSScheduledJob 模組中包含的 Cmdlet 詳細資訊，請參閱 PSScheduledJob。

如何建立排程工作

若要建立排程的工作，請使用 Register-ScheduledJob Cmdlet。 Cmdlet 需要作業執行的名稱和命令或腳本。您可以新增 RunNow 參數來立即執行作業，或在建立作業時建立作業觸發程式並設定作業選項，或編輯現有的作業。

若要建立執行腳本的作業，請使用 FilePath 參數來指定腳本檔案的路徑。若要建立執行命令的作業，請使用 ScriptBlock 參數。

Cmdlet Register-ScheduledJob 會 建立 ProcessJob，其會執行 Get-Process 命令。此排程工作具有預設的作業選項，而且沒有作業觸發程式。

Register-ScheduledJob -Name ProcessJob -ScriptBlock { Get-Process }

Id         Name            Triggers        Command       Enabled
--         ----            --------        -------       -------
8          ProcessJob      {}              Get-Process   True

如何建立作業觸發程式

作業觸發程式會自動啟動排程的工作。作業觸發程式可以是一次性或週期性排程或事件，例如使用者登入或 Windows 啟動時。每個作業可以有零個、一個或多個作業觸發程式。

若要建立作業觸發程式，請使用 New-JobTrigger Cmdlet。下列命令會建立作業觸發程式，以在每個星期一和星期四上午 5：00 啟動作業。命令會將作業觸發程式儲存在變數中 $T 。

$T = New-JobTrigger -Weekly -DaysOfWeek "Monday", "Thursday" -At "5:00 AM"

作業觸發程式是選擇性的。您可以隨時將 RunNow 參數新增至命令Register-ScheduledJob，或使用 Start-Job Cmdlet 來啟動排程工作。

如何新增作業觸發程式

當您將作業觸發程式新增至排程工作時，作業觸發程式會新增至排程工作的排程工作 XML 檔案，並成為排程工作的一部分。

您可以在建立排程工作時，將作業觸發程式新增至排程工作，或編輯現有的作業。您可以隨時變更排程工作的工作觸發程式。

PowerShell 會使用工作排程器所使用的一些相同作業觸發程式。如需作業觸發程式的詳細資訊，請參閱 New-JobTrigger Cmdlet 的說明主題。

下列範例會使用 Splatting 來建立 $JobParms 傳遞至 Register-ScheduledJob Cmdlet 的參數值。如需詳細資訊，請參閱 about_Splatting.md。會 Register-ScheduledJob 使用 @JobParms 來建立排程的工作。它會使用 Trigger 參數來指定變數中的 $T 作業觸發程式。

$JobParms = @{
  Name = "ProcessJob"
  ScriptBlock = {Get-Command}
  Trigger = $T
}

Register-ScheduledJob @JobParms

您也可以隨時將作業觸發程式新增至現有的排程工作。 Cmdlet 會將 Add-JobTrigger 變數中的 $T 作業觸發程式新增至 ProcessJob 排程工作。

Add-JobTrigger -Name ProcessJob -Trigger $T

因此，作業觸發程式會在每週一和星期四上午 5：00 自動啟動 ProcessJob 。

如何取得作業觸發程式

若要取得排程作業的作業觸發程式，請使用 Get-JobTrigger Cmdlet。 使用 Name、ID 和 InputObject 參數來指定排程的工作，而不是作業觸發程式。

Get-JobTrigger會取得 ProcessJob 的作業觸發程式。

Get-JobTrigger -Name ProcessJob

Id   Frequency       Time                   DaysOfWeek              Enabled
--   ---------       ----                   ----------              -------
1    Weekly          11/7/2011 5:00:00 AM   {Monday, Thursday}      True

如何建立作業選項

作業選項會建立啟動和執行作業的條件。除非您變更預設作業選項，否則每個作業都有預設的作業選項。因為作業選項可以防止作業在排程時間執行，所以請務必瞭解作業選項，並仔細使用它們。

PowerShell 會使用工作排程器所使用的相同作業選項。如需作業選項的詳細資訊，請參閱 New-ScheduledJobOption 的說明主題。

作業選項會儲存在排程的作業 XML 檔案中。您可以在建立排程工作時設定作業選項，或隨時變更它們。

Cmdlet New-ScheduledJobOption 會建立排程的作業選項，其中 WakeToRun 排程工作選項設定為 True。 WakeToRun 選項會執行排程的工作，即使計算機處於排程開始時間的睡眠或休眠狀態也一樣。命令會將作業選項儲存在變數中 $O 。

$O = New-ScheduledJobOption -WakeToRun

如何取得作業選項

若要取得排程作業的作業選項，請使用 Get-ScheduledJobOption Cmdlet。 使用 Name、ID 和 InputObject 參數來指定排程的作業，而不是作業選項。

Get-ScheduledJobOption會取得 ProcessJob 的作業選項。

Get-ScheduledJobOption -Name ProcessJob

StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

如何變更作業選項

當您建立排程工作或編輯現有的作業時，您可以變更排程作業的作業選項。

Splatted $JobParms 會傳遞至 Add-JobTrigger Cmdlet 以建立進程作業。它會使用 ScheduledJobOption 參數來指定變數中的 $O 作業選項。

$JobParms = @{
  Name = "ProcessJob"
  ScriptBlock = {Get-Process}
  ScheduledJobOption = $O
}

Add-JobTrigger @JobParms

您也可以隨時將作業選項變更為現有的排程工作。下列命令會Set-ScheduledJobOption使用 Cmdlet 將 ProcessJob scheduledJob 的 WakeToRun 選項值變更為 True。

Set PSScheduledJob 模組中的 Cmdlet，例如 Set-ScheduledJobOption Cmdlet，沒有 Name 或 ID 參數。您可以使用 InputObject 參數來指定排程的工作選項，或使用管線將排程工作從 Get-ScheduledJobOption Cmdlet 傳送至 Set-ScheduledJobOption。

此範例會 Get-ScheduledJob 使用 Cmdlet 來取得 ProcessJob。它會使用 Get-ScheduledJobOption Cmdlet 來取得 ProcessJob Set-ScheduledJobOption 和 Cmdlet 中的作業選項，將 ProcessJob 中的 WakeToRun 作業選項變更為 True。

Get-ScheduledJob -Name ProcessJob | Get-ScheduledJobOption |
 Set-ScheduledJobOption -WakeToRun

如何取得排程的工作實例

啟動排程工作時，PowerShell 會建立類似於標準 PowerShell 背景作業的作業實例。您可以使用作業 Cmdlet，例如 Get-Job， Stop-Job 和 Receive-Job 來管理作業實例。

注意

若要在排程工作的實例上使用作業 Cmdlet， 必須將 PSScheduledJob 模組匯入會話。若要匯入 PSScheduledJob 模組，請輸入 Import-Module PSScheduledJob 或使用任何排程的工作 Cmdlet，例如 Get-ScheduledJob。

若要取得 PowerShell 排程工作的所有實例，以及所有使用中 Get-Job 標準作業，請使用 Cmdlet。 Cmdlet 會 Import-Module 匯入 PSScheduledJob 模組，並在 Get-Job 本機計算機上取得作業。

Import-Module PSScheduledJob
Get-Job

Get-Job會取得本機電腦上的 ProcessJob 實例。

Get-Job -Name ProcessJob

Id     Name        PSJobTypeName  State    HasMoreData   Location   Command
--     ----        ------------   -----    -----------   --------   -------
45     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
46     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
47     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
48     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
49     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
50     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
51     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process

默認顯示不會顯示開始時間，這通常會區分相同排程作業的實例。

Cmdlet 會將 Get-Job 對象傳送至管線。 Cmdlet Format-Table 會顯示排程工作的名稱、標識碼和 BeginTime 屬性。

Get-Job ProcessJob | Format-Table -Property Name, ID, BeginTime

Name       Id BeginTime
----       -- ---------
ProcessJob 43 11/2/2011 3:00:02 AM
ProcessJob 44 11/3/2011 3:00:02 AM
ProcessJob 45 11/4/2011 3:00:02 AM
ProcessJob 46 11/5/2011 3:00:02 AM
ProcessJob 47 11/6/2011 3:00:02 AM
ProcessJob 48 11/7/2011 12:00:01 AM
ProcessJob 49 11/7/2011 3:00:02 AM
ProcessJob 50 11/8/2011 3:00:02 AM

取得排程的作業結果

若要取得排程作業實例的結果，請使用 Receive-Job Cmdlet。

注意

此範例會取得 ProcessJob 排程工作的最新實例結果（ID = 51）。

Import-Module PSScheduledJob
Receive-Job -ID 51 -Keep

排程工作的結果會儲存在磁碟上，因此 不需要Keep 參數 Receive-Job 。不過，如果沒有 Keep 參數，您只能在每個 PowerShell 工作階段中取得排程工作的結果一次。若要啟動新的 PowerShell 工作階段，請輸入 PowerShell 或開啟新的 PowerShell 視窗。

共用方式為