共用方式為


Receive-Job

取得目前工作階段中 Windows PowerShell 背景工作的結果。

語法

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>]

描述

Receive-Job Cmdlet 會取得 Windows PowerShell 背景工作的結果。請使用 Receive-Job 取得使用 Start-Job Cmdlet 或是任何 Cmdlet 的 AsJob 參數所啟動之工作的結果。您可以依工作的名稱、識別碼、執行個體識別碼、電腦名稱、位置或工作階段,或是透過提交工作物件的方式,取得所有工作的結果或識別工作。

當您啟動 Windows PowerShell 背景工作時,工作隨即啟動,但是結果並不會立即出現。事實上,命令會傳回表示背景工作的物件。工作物件包含有用的工作資訊,但不包含結果。這個方法可讓您在工作執行時,繼續在工作階段中執行作業。如需 Windows PowerShell 中背景工作的詳細資訊,請參閱 about_Jobs。

若要取得命令的結果,請使用 Receive-Job Cmdlet。Receive-Job 會取得截至提交 Receive-Job 命令時,已經產生的結果。如果結果還不完整,您可以執行額外的 Receive-Job 命令,取得剩餘的結果。

根據預設,工作結果在接收後便會從系統刪除,但是您可以使用 Keep 參數儲存結果,以便重新接收結果。若要刪除工作結果,請重新接收結果 (不指定 Keep 參數)、關閉工作階段,或是使用 Remove-Job Cmdlet 刪除工作階段中的工作。

參數

-ComputerName <string[]>

取得在指定電腦執行之工作的結果。請輸入電腦名稱。預設為目前工作階段中的所有工作。

此參數會從儲存在本機電腦的工作結果進行選擇,而不會從遠端電腦取得資料。若要取得儲存在遠端電腦的工作結果,請使用 Invoke-Command Cmdlet 從遠端執行 Receive-Job 命令。

必要?

false

位置?

2

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Id <Int32[]>

取得具有所指定識別碼之工作的結果。預設為目前工作階段中的所有工作。

識別碼是整數,可唯一識別目前工作階段內的工作。它比執行個體識別碼更容易記得和輸入,但是只有在目前的工作階段中才具有唯一性。您可以輸入一個或多個識別碼 (以逗號分隔)。若要尋找工作的識別碼,請輸入 "Get-Job" 且不要指定參數。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-InstanceId <Guid[]>

取得具有所指定執行個體識別碼之工作的結果。預設為目前工作階段中的所有工作。

執行個體識別碼是一種 GUID,它能夠唯一識別電腦上的工作。若要尋找工作的執行個體識別碼,請使用 Get-Job Cmdlet。

必要?

false

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Job <Job[]>

指定要擷取其結果的工作。此參數為 Receive-Job 命令的必要項。請輸入包含工作的變數或可取得工作的命令。您也可以經由管道將工作物件輸出至 Receive-Job。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByValue, ByPropertyName)

接受萬用字元?

false

-Keep

將工作結果儲存於系統中,即使在您已經接收工作結果後也是如此。在擷取工作結果後,預設會刪除工作結果。

若要刪除結果,請重新使用 Receive-Job 而不指定 Keep 參數來接收結果、關閉工作階段,或是使用 Remove-Job Cmdlet 刪除工作階段中的工作。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Location <string[]>

只取得具有所指定位置之工作的結果。預設為目前工作階段中的所有工作。

必要?

false

位置?

2

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Name <string[]>

取得具有所指定好記名稱之工作的結果。預設為目前工作階段中的所有工作。

必要?

false

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-NoRecurse

只從指定的工作中取得結果。根據預設,Receive-Job 也會取得所指定工作之所有子工作的結果。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Session <PSSession[]>

取得在指定之 Windows PowerShell 工作階段 (PSSession) 執行之工作的結果。請輸入包含 PSSession 的變數或可取得 PSSession 的命令,例如 Get-PSSession 命令。預設為目前工作階段中的所有工作。

必要?

false

位置?

2

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.Job

您可以經由管道將工作物件輸出至 Receive-Job。

輸出

PSObject

Receive-Job 會傳回工作中命令的結果。

範例 1

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 參數指定工作。





範例 2

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

C:\PS> $job | receive-job

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





範例 3

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 參數儲存工作結果 (即使已經接收過工作結果也一樣)。





範例 4

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 的值。





請參閱

概念

about_Jobs
about_Job_Details
about_remote_jobs
Start-Job
Get-Job
Wait-Job
Stop-Job
Remove-Job
Invoke-Command