Wait-Job

Wait-Job [[-InstanceId] <Guid[]>] [-Any] [-Timeout <int>] [<CommonParameters>]

Wait-Job [-Job] <Job[]> [-Any] [-Timeout <int>] [<CommonParameters>]

Wait-Job [[-Name] <string[]>] [-Any] [-Timeout <int>] [<CommonParameters>]

Wait-Job [-Id] <Int32[]> [-Any] [-Timeout <int>] [<CommonParameters>]

Wait-Job [-State {<NotStarted> | <Running> | <Completed> | <Failed> | <Stopped> | <Blocked>}] [-Any] [-Timeout <int>] [<CommonParameters>]

C:\PS>get-job | wait-job

描述
-----------
這個命令會等待工作階段中正在執行的所有背景工作執行完成。

C:\PS>$s = new-pssession server01, server02, server03

C:\PS> invoke-command -session $s -scriptblock {start-job -name Date1 -scriptblock {get-date}}

C:\PS> $done = invoke-command -session $s -command {wait-job -name Date1}

C:\PS> $done.count
3

描述
-----------
在這個範例中，會示範如何使用 Wait-Job Cmdlet，處理利用 Start-Job Cmdlet 在遠端電腦啟動的工作。Start-Job 和 Wait-Job 命令都是利用 Invoke-Command Cmdlet 提交到遠端電腦。

範例中使用 Wait-Job 判斷在三台不同電腦上，當做背景工作執行的 Get-Date 命令是否已完成。

第一個命令會分別在三台遠端電腦上建立 Windows PowerShell 工作階段 (PSSession)，並將它們儲存在 $s 變數中。

第二個命令會使用 Invoke-Command Cmdlet，在 $s 中的三個工作階段內分別執行 Start-Job 命令。所有的工作都命名為 Date1。

第三個命令會使用 Invoke-Command Cmdlet 執行 Wait-Job 命令，並等待每部電腦的 Date1 工作執行完成，然後將產生的工作物件集合 (陣列) 儲存在 $done 變數中。

第四個命令會使用 $done 變數中工作物件陣列的 Count 屬性判斷已完成的工作數目。

C:\PS>$s = new-pssession (get-content machines.txt)  

C:\PS> $c = 'get-eventlog -log system | where {$_.EntryType -eq "error" -and $_.Source -eq "LSASRV"} | out-file errors.txt'

C:\PS> invoke-command -session $s -scriptblock {param($c)start-job -scriptblock {$c}} -ArgumentList $c

C:\PS> invoke-command -session $s -scriptblock {wait-job -any}

描述
-----------
這個範例會使用 Wait-Job 的 Any 陣列，判斷目前工作階段裡正在執行的許多背景工作中，第一項工作完成的時間。範例中也會示範如何使用 Wait-Job Cmdlet 等待遠端工作執行完成。

第一個命令會在 Machines.txt 檔案中列出的每一部電腦建立 PSSession，並將這些 PSSession 儲存在 $s 變數中。這個命令會使用 Get-Content Cmdlet 取得該檔案的內容。Get-Content 命令放在括號內，確保它會在 New-PSSession 命令之前執行。

第二個命令會將 Get-EventLog 命令字串 (置於引號內) 儲存在 $c 變數中。

第三個命令會使用 Invoke-Command Cmdlet，在 $s 中的每個工作階段內執行 Start-Job 命令。Start-Job 命令會啟動一項背景工作，此工作會執行 $c 中的命令。

因為 $c 變數位於本機電腦上，所以此命令會使用 "param" 關鍵字在命令中宣告區域變數，並使用 ArgumentList 參數提供這些變數的值。

第四個命令會使用 Invoke-Command Cmdlet，在工作階段中執行 Wait-Job 命令。它會使用 Wait-Job Cmdlet 來等候直到遠端電腦上的第一項工作完成為止。

C:\PS>$s = new-pssession Server01, Server02, Server03 

C:\PS> $jobs = invoke-command -session $s -scriptblock {start-job -script {get-date}}

C:\PS> $done = invoke-command -session $s -scriptblock {wait-job -timeout 30}

描述
-----------
在這個範例中，會示範如何使用 Wait-Job 的 Timeout 參數，設定在遠端電腦執行之工作的等待時間上限。

第一個命令會分別在三台遠端電腦 (Server01、Server02 和 Server03) 上建立 PSSession，並將這些 PSSession 儲存在 $s 變數中。

第二個命令會使用 Invoke-Command Cmdlet，在 $s 中的每個 PSSession 內執行 Start-Job 命令。它會將產生的工作物件儲存在 $jobs 變數中。

第三個命令會使用 Invoke-Command Cmdlet，在 $s 中的每個 PSSessions 內執行 Wait-Job 命令。Wait-Job 命令會判斷所有的命令是否都已在 30 秒內執行完成。它會使用值為 30 (秒) 的 Timeout 參數來建立等待時間上限，並將命令的結果儲存在 $done 變數中。

在本例中，經過 30 秒之後，只有 Server02 電腦上的命令執行完成。Wait-Job 會結束等候、顯示命令提示字元，並傳回表示已完成之工作的物件。

$done 變數包含表示在 Server02 執行之工作的工作物件。

C:\PS>wait-job -id 1,2,5 -any

描述
-----------
這個命令會依識別碼來識別三項工作，並等到其中任一工作執行完成。當第一項工作完成時，命令提示字元就會傳回。

C:\PS>wait-job -name DailyLog -timeout 120

描述
-----------
這個命令會等待 120 秒 (兩分鐘)，讓 DailyLog 工作完成。如果工作未能在接下來的兩分鐘內完成，命令提示字元還是會傳回，而且工作也會繼續在背景執行。

C:\PS>wait-job -name Job3

描述
-----------
此 Wait-Job 命令會使用工作名稱識別要等待的工作名稱。

C:\PS>C:\PS> $j = start-job -script {get-childitem *.ps1| where {$_lastwritetime -gt ((get-date) - (new-timespan -days 7))}}

C:\PS> $j | wait-job

描述
-----------
在這個範例中，會示範如何使用 Wait-Job Cmdlet，處理利用 Start-Job Cmdlet 在本機電腦啟動的工作。

這些命令會啟動一項工作，取得前一週新增或更新的 Windows PowerShell 指令碼檔案。

第一個命令會使用 Start-Job Cmdlet，在本機電腦啟動背景工作。該工作會執行 Get-ChildItem 命令，以取得前一週新增或更新，而且副檔名為 ".ps1" 的所有檔案。

第三個命令會使用 Wait-Job Cmdlet 等到工作執行完成。當工作完成時，此命令會顯示包含工作相關資訊的工作物件。

C:\PS>$s = new-pssession Server01, Server02, Server03

C:\PS> $j = invoke-command -session $s -scriptblock {get-process} -asjob

C:\PS> $j | wait-job

描述
-----------
在這個範例中，會示範如何使用 Wait-Job Cmdlet 處理利用 Invoke-Command Cmdlet 的 AsJob 參數在遠端電腦啟動的工作。使用 AsJob 時，即使工作是在遠端電腦執行，但仍是在本機電腦建立工作，而且結果也會自動傳回到本機電腦。

範例中使用 Wait-Job 判斷在三部遠端電腦之執行階段中執行的 Get-Process 命令是否已完成。

第一個命令會在三台電腦上建立 PSSession，並將它們儲存在 $s 變數中。

第二個命令會使用 Invoke-Command Cmdlet，在 $s 中的三個 PSSession 內分別執行 Get-Process 命令。這個命令會使用 AsJob 參數，將命令當做背景工作以非同步方式執行。與使用 Start-Job 啟動的工作一樣，這個命令會傳回工作物件，而且會將工作物件儲存在 $j 變數中。

第三個命令會使用管線運算子 (|)，將 $j 中的工作物件傳送到 Wait-Job Cmdlet。請注意，此範例不需要 Invoke-Command 命令，因為工作是位於本機電腦。

C:\PS>get-job

Id   Name     State      HasMoreData     Location             Command
--   ----     -----      -----------     --------             -------
1    Job1     Completed  True            localhost,server01.. get-service
4    Job4     Completed  True            localhost            dir | where

C:\PS> wait-job -id 1

描述
-----------
這個命令會等待 ID 值為 1 的工作。