Receive-Job

Receive-Job [-Job] <Job[]> [[-ComputerName] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [[-InstanceId] <Guid[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Job] <Job[]> [[-Location] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [[-Name] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Job] <Job[]> [[-Session] <PSSession[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Id] <Int32[]> [-Keep] [-NoRecurse] [<CommonParameters>]

C:\PS>$job = start-job -scriptblock {get-process}

C:\PS> receive-job -job $job

描述
-----------
這些命令會使用 Job 參數取得特定工作的結果。第一個命令會使用 Start-Job Cmdlet，啟動執行 "Get-Process" 命令的工作。這個命令會使用指定運算子 (=)，將產生的工作物件儲存在 $job 變數中。

第二個命令會使用 Receive-Job Cmdlet 取得工作結果，並使用 Job 參數指定工作。

C:\PS>$job = start-job -scriptblock {get-process}

C:\PS> $job | receive-job

描述
-----------
這個範例與範例 2 相同，唯一的不同是這個命令會使用管線運算子 (|)，將工作物件傳送給 Receive-Job。因此，這個命令並不需要使用 Job 參數指定工作。

C:\PS>$j = invoke-command -computername Server01, Server02, Server03 -scriptblock {get-service} -AsJob

C:\PS> $j.childjobs

Id   Name     State      HasMoreData   Location       Command
--   ----     -----      -----------   --------       -------
2    Job2     Completed  True          Server01       get-service
3    Job3     Completed  True          Server02       get-service
4    Job4     Completed  True          Server03       get-service

C:\PS> receive-job -name Job3  -keep

Status  Name        DisplayName                        PSComputerName
------  ----------- -----------                        --------------
Running AeLookupSvc Application Experience             Server02
Stopped ALG         Application Layer Gateway Service  Server02
Running Appinfo     Application Information            Server02
Running AppMgmt     Application Management             Server02

描述
-----------
這些命令會使用 Receive-Job 的 Name 參數，取得在遠端電腦上執行之其中一個背景工作的結果。

第一個命令會使用 Invoke-Command Cmdlet 啟動在三部遠端電腦執行 Get-Service 命令的背景工作。這個命令會使用 AsJob 參數，將命令當做背景工作來執行，並將產生的工作物件儲存在 $j 變數中。

使用 Invoke-Command 的 AsJob 參數啟動工作時，即使工作是在遠端電腦執行，仍會在本機電腦建立工作物件。因此，請使用本機命令來管理工作。

此外，當您使用 AsJob 時，Windows PowerShell 也會傳回一個工作物件，其中包含已啟動之每項工作的子工作。在本例中，工作物件包含三項子工作，每部遠端電腦的每一項工作各一項子工作。

第二個命令會使用點標記法，顯示 $j 中工作物件的 ChildJobs 屬性值。顯示中列出此命令建立的三項子工作，每部遠端電腦的工作各一項子工作。
 
第三個命令會使用 Receive-Job Cmdlet 取得在 Server02 電腦執行之 Job3 子工作的結果。這個命令會使用 Name 參數指定子工作的名稱，並使用 Keep 參數儲存工作結果 (即使已經接收過工作結果也一樣)。

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

C:\PS> $j = invoke-command -session $s -scriptblock {start-job -scriptblock {get-eventlog -logname system}}

C:\PS> $j

Id   Name     State      HasMoreData   Location   Command
--   ----     -----      -----------   --------   -------
1    Job1     Completed  True          Localhost  get-eventlog system
2    Job2     Completed  True          Localhost  get-eventlog system
3    Job3     Completed  True          Localhost  get-eventlog system

C:\PS> $results = invoke-command -session $s -scriptblock {param($j) receive-job -job $j} -ArgumentList $j

描述
-----------
這個範例會示範如何取得在三部遠端電腦上執行之背景工作的結果。

第一個命令會使用 New-PSSession Cmdlet 建立三個 PSSession (在命令中指定的每部伺服器各建立一個)，並將這些 PSSession 儲存在 $s 變數中。

第二個命令會使用 Invoke-Command Cmdlet，對 $s 變數中的每個 PSSession 執行 Start-Job 命令。該工作會執行 Get-Eventlog 命令，以取得系統記錄檔中的事件。這個命令會將結果儲存在 $j 變數中。

由於這個命令是使用 Invoke-Command 來執行 Start-Job 命令，因此它實際上是在這三部電腦上分別啟動三個獨立的工作。因此，這個命令便傳回三個工作物件，代表在三部不同電腦上，以本機方式執行的三項工作。

第三個命令會顯示 $j 中三個工作物件。

第四個命令會使用 Invoke-Command，在 $s 的每個 PSSession 中執行 Receive-Job 命令並將結果儲存在 $results 變數中。

因為 $j 是本機變數，所以指令碼區塊會使用 "param" 關鍵字在命令中宣告變數，並使用 ArgumentList 參數來提供 $j 的值。