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

Descrição
-----------
Esses comandos usam o parâmetro Job para obter os resultados de um trabalho específico. O primeiro comando usa o cmdlet Start-Job para iniciar um trabalho que executa um comando "Get-Process". O comando usa o operador de atribuição (=) para salvar o objeto de trabalho resultante na variável $job.

O segundo comando utiliza o cmdlet Receive-Job para obter os resultados do trabalho. Ele usa o parâmetro Job para especificar o trabalho.

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

C:\PS> $job | receive-job

Descrição
-----------
Esse exemplo é igual ao Exemplo 2, a não pelo fato de que o comando usa um operador de pipeline (|) para enviar o objeto de trabalho para Receive-Job. Dessa forma, o comando não precisa de um parâmetro Job para especificar o trabalho.

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

Descrição
-----------
Esses comandos usam o parâmetro Name de Receive-Job para obter os resultados de um entre vários trabalhos em segundo plano executados em computadores remotos. 

O primeiro comando usa o cmdlet Invoke-Command para iniciar um trabalho em segundo plano que executa um comando Get-Service em três computadores remotos. O comando usa o parâmetro AsJob para executar o comando como um trabalho em segundo plano. O comando salva o objeto de trabalho resultante na variável $j.

Quando você usa o parâmetro AsJob de Invoke-Command para iniciar um trabalho, o objeto de trabalho é criado no computador local, mesmo que o trabalho seja executado nos computadores remotos. Dessa forma, você usa comandos locais para gerenciar o trabalho.

Além disso, quando você usa AsJob, o Windows PowerShell retorna um objeto de trabalho que contém um trabalho filho para cada trabalho que foi iniciado. Nesse caso, o objeto de trabalho contém três trabalhos filho, um para cada trabalho em cada computador remoto.

O segundo comando usa o método de ponto para exibir o valor da propriedade ChildJobs do objeto de trabalho em $j. O vídeo mostra que o comando criou três trabalhos filho, um para o trabalho em cada computador remoto.
 
O terceiro comando usa o cmdlet Receive-Job para obter os resultados do trabalho filho Job3 que foi executado no computador Server02. Ele usa o parâmetro Name para especificar o nome do trabalho filho e o parâmetro Keep para salvar os resultados do trabalho, mesmo depois de eles serem recebidos.

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

Descrição
-----------
Este exemplo mostra como obter os resultados de trabalhos em segundo plano executados em três computadores remotos.

O primeiro comando usa o cmdlet New-PSSession para criar três PSSessions, um em cada um dos servidores especificados no comando. Ele salva as PSSessions na variável $s.

O segundo comando usa o cmdlet Invoke-Command para executar um comando Start-Job em cada uma das PSSessions na variável $s. O trabalho executa um comando Get-Eventlog que obtém os eventos no log do sistema. O comando salva os resultados na variável $j.

Como o comando usou Invoke-Command para executar o comando Start-Job, o comando na verdade iniciou três trabalhos independentes em cada um dos três computadores. Desse modo, o comando retornou três objetos de trabalho que representam três trabalhos executados localmente em três computadores diferentes.

O terceiro comando exibe os três objetos de trabalho em $j.  

O quarto comando usa Invoke-Command para executar um comando Receive-Job em cada uma das PSSessions em $s e salvar os resultados na variável $results.

Como $j é uma variável local, o bloco de scripts usa a palavra-chave "param" para declarar as variáveis no comando e o parâmetro ArgumentList para fornecer o valor de $j.