關於招聘

簡短描述

提供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。

另請參閱

關於遠端工作

about_Job_Details

遠端相關資訊

about_PSSessions

Start-Job (開始任務)

獲取作業

接收任務

停止作業

等待任務

刪除作業

調用命令