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