簡短描述
提供PowerShell背景作業如何在背景中執行命令或表達式,而不需與目前會話互動的相關信息。
長描述
本主題介紹如何在本地電腦上的PowerShell中運行後台作業。 有關在遠端電腦上運行後台作業的資訊,請參閱 about_Remote_Jobs。
當您啟動背景工作時,即使作業需要較長的時間才能完成,命令提示字元仍會立即傳回。 您可以在會話中繼續工作,即使在作業執行時也不會中斷。
作業 cmdlet
| cmdlet | 說明 |
|---|---|
Start-Job |
在本地電腦上啟動後台作業。 |
Get-Job |
獲取在 |
| 當前工作階段。 | |
Receive-Job |
獲取後台作業的結果。 |
Stop-Job |
停止後台作業。 |
Wait-Job |
禁止命令提示符,直到一個或所有作業都 |
| 完成。 | |
Remove-Job |
刪除後台作業。 |
Invoke-Command |
AsJob 參數將任何命令作為後台運行 |
| job 在遠端電腦上。 您還可以使用 | |
Invoke-Command 要遠端運行任何 job 命令, |
|
| 包括 Start-Job 命令。 |
如何在本地電腦上啟動作業
若要在本地電腦上啟動後台作業,請使用 Start-Job cmdlet。
要編寫 Start-Job 命令,請將作業運行的命令括在大括弧 ( { } ) 中。 使用 ScriptBlock 參數指定命令。
下列命令會啟動在本機計算機上執行 Get-Process 命令的背景工作。
Start-Job -ScriptBlock {Get-Process}
Start-Job 命令會傳回代表作業的物件。 job 物件包含有關作業的有用資訊,但不包含 job 結果。
將 job 物件保存在變數中,然後將其與其他 Job cmdlet 一起使用來管理後台作業。 以下命令啟動一個 job 物件,並將生成的 job 物件保存在 $job 變數中。
$job = Start-Job -ScriptBlock {Get-Process}
您還可以使用 Get-Job cmdlet 獲取表示當前工作階段中啟動的作業的物件。
Get-Job 返回 Start-Job 傳回的相同 Job 物件。
獲取作業物件
若要獲取表示當前會話中啟動的後台作業的物件,請使用 Get-Job cmdlet。 如果沒有參數,Get-Job 會傳回目前會話中啟動的所有作業。
例如,以下命令獲取當前會話中的作業。
PS C:> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Running True localhost Get-Process
您還可以將job物件保存在變數中,並在以後的命令中使用它來表示job。 以下命令獲取ID為1的作業並將其保存在 $job變數中。
$job = Get-Job -Id 1
作業物件包含作業的狀態,指出作業是否已完成。 已完成的作業的狀態為 「Complete」 或 「Failed」。 作業也可能被阻止或正在運行。
Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
獲取作業的結果
當您運行後台作業時,結果不會立即顯示。
相反,Start-Job cmdlet 返回表示作業的作業物件,但它不包含結果。 若要取得背景工作的結果,請使用 Receive-Job Cmdlet。
下列命令會使用 Receive-Job Cmdlet 來取得作業的結果。 它使用保存在 $job 變數中的作業物件來標識作業。
Receive-Job -Job $job
Receive-Job cmdlet 返回作業的結果。
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
668 7 2672 6168 104 32.26 488 csrss
# ...
您還可以將作業的結果保存在變數中。 以下命令將 $job 變數中的作業結果保存到 $results 變數中。
$results = Receive-Job -Job $job
此外,您可以使用重定向運算符 ()> 或 Out-File cmdlet 將作業結果保存在檔案中。 以下命令使用 redirection 運算子將作業結果保存在 Results.txt 檔的 $job 變數中。
Receive-Job -Job $job > results.txt
獲取和保留部分作業結果
Receive-Job cmdlet 獲取後台作業的結果。 如果作業已完成,Receive-Job 取得所有作業結果。 如果作業仍在運行,Receive-Job 將獲得到目前為止生成的結果。
您可以再次執行 Receive-Job 命令,以取得剩餘的結果。
當返回結果時 Receive-Job ,預設情況下,它會從存儲作業結果的緩存中刪除這些結果。 如果運行其他 Receive-Job 命令,則只會獲得尚未收到的結果。
下列命令會顯示 Receive-Job 命令在作業完成之前執行的結果。
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
要防止 Receive-Job 刪除它返回的作業結果,請使用 Keep 參數。 因此, Receive-Job 返回在該時間之前已生成的所有結果。
以下命令顯示了在尚未完成的任務上使用 Keep 參數的效果。
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
等待結果
如果您執行需要很長的時間才能完成的命令,您可以使用作業對象的屬性來判斷作業何時完成。 以下命令使用該 Get-Job 物件獲取當前會話中的所有後台作業。
Get-Job
結果會出現在數據表中。 任務的狀態將顯示在 State (狀態) 列中。
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
2 Job2 BackgroundJob Running True localhost Get-EventLog -Log ...
3 Job3 BackgroundJob Complete True localhost dir -Path C:\* -Re...
在這種情況下,State 屬性顯示作業 2 仍在運行。 如果您要使用 Receive-Job Cmdlet 立即取得作業結果,結果將會不完整。 您可以重複使用 Receive-Job Cmdlet 來取得所有結果。 默認情況下,每次使用它時,您只會獲得尚未收到的結果,但您可以使用 Receive-Job cmdlet 的 Keep 參數來保留結果,即使這些結果已經收到。
您可以將部分結果寫入檔,然後在新結果到達時附加它們,也可以等待並稍後檢查作業的狀態。
您可以使用 cmdlet 的 Receive-Job Wait 參數,該參數在作業完成且所有結果都可用之前不會返回命令提示符。
您也可以使用 Wait-Job Cmdlet 來等候作業的任何或所有結果。
Wait-Job 允許您等待特定作業、所有作業或任何作業完成。
以下命令使用 Wait-Job cmdlet 等待 ID 為 10 的作業。
Wait-Job -ID 10
因此,PowerShell 提示會隱藏,直到作業完成為止。
您也可以等候預先決定的時間。 此命令使用 Timeout 參數將等待時間限制為 120 秒。 當時間到期時,命令提示字元會傳回,但工作會繼續在背景中執行。
Wait-Job -ID 10 -Timeout 120
停止作業
若要停止背景工作,請使用 Stop-Job Cmdlet。 下列命令會啟動作業,以取得系統事件記錄檔中的每個專案。 它將job物件保存在$job變數中。
$job = Start-Job -ScriptBlock {Get-EventLog -Log System}
下列命令會停止作業。 它使用導管運算子 (|) 將 $job 變數 Stop-Job中的作業傳送到 。
$job | Stop-Job
刪除作業
若要刪除背景工作,請使用 Remove-Job Cmdlet。 以下命令將刪除 $job 變數中的作業。
Remove-Job -Job $job
調查失敗的作業
要找出作業失敗的原因,請使用job物件的 Reason 子屬性。
以下命令在沒有所需憑證的情況下啟動作業。 它將job物件保存在$job變數中。
$job = Start-Job -ScriptBlock {New-Item -Path HKLM:\Software\MyCompany}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost New-Item -Path HKLM:...
以下命令使用 Reason 屬性尋找導致作業失敗的錯誤。
$job.ChildJobs[0].JobStateInfo.Reason
在此情況下,作業失敗,因為遠端計算機需要明確的認證才能執行命令。 Reason 屬性的值為:
連接到遠端伺服器失敗,並顯示以下錯誤消息:Access is denied。