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

Descripción
-----------
Estos comandos utilizan el parámetro Job para obtener los resultados de un trabajo concreto. El primer comando utiliza el cmdlet Start-Job para iniciar un trabajo que ejecuta un comando "Get-Process". El comando utiliza el operador de asignación (=) para guardar el objeto de trabajo resultante en la variable $job.

El segundo comando utiliza el cmdlet Receive-Job para obtener los resultados del trabajo. Usa el parámetro Job para especificar el trabajo.

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

C:\PS> $job | receive-job

Descripción
-----------
Este ejemplo es como el Ejemplo 2, con la salvedad de que el comando utiliza un operador de canalización (|) para enviar el objeto de trabajo a Receive-Job. Como consecuencia, el comando no necesita un parámetro Job para especificar el trabajo.

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

Descripción
-----------
Estos comandos utilizan el parámetro Name de Receive-Job para obtener los resultados de uno de los trabajos en segundo plano que se ejecutan en equipos remotos. 

El primer comando utiliza el cmdlet Invoke-Command para iniciar un trabajo en segundo plano que ejecuta un comando Get-Service en tres equipos remotos. El comando utiliza el parámetro AsJob para ejecutar el comando como un trabajo en segundo plano. El comando guarda el objeto de trabajo resultante en la variable $j.

Cuando se utiliza el parámetro AsJob de Invoke-Command para iniciar un trabajo, el objeto de trabajo se crea en el equipo local, aunque el trabajo se ejecute en los equipos remotos. Como consecuencia, se utilizan comandos locales para administrar el trabajo.

Además, cuando se utiliza AsJob, Windows PowerShell devuelve un objeto de trabajo que contiene un trabajo secundario para cada trabajo iniciado. En este caso, el objeto de trabajo contiene tres trabajos secundarios, uno para cada trabajo en cada equipo remoto.

El segundo comando usa el método de puntos para mostrar el valor de la propiedad ChildJobs del objeto de trabajo en $j. La presentación muestra que el comando creó tres trabajos secundarios, uno para el trabajo en cada equipo remoto.
 
El tercer comando usa el cmdlet Receive-Job para obtener los resultados del trabajo secundario Job3 que se ejecutó en el equipo Server02. Utiliza el parámetro Name para especificar el nombre del trabajo secundario y el parámetro Keep para guardar los resultados del trabajo después de haberse recibido.

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

Descripción
-----------
En este ejemplo se muestra la forma de obtener los resultados de los trabajos en segundo plano ejecutados en tres equipos remotos.

El primer comando utiliza el cmdlet New-PSSession para crear tres PSSessions, una en cada uno de los servidores especificados en el comando. Guarda las PSSessions en la variable $s.

El segundo comando usa el cmdlet Invoke-Command para ejecutar un comando Start-Job en cada una de las PSSessions de la variable $s. El trabajo ejecuta un comando Get-Eventlog que obtiene los eventos en el registro del sistema. El comando guarda los resultados en la variable $j.

Dado que el comando utilizó Invoke-Command para ejecutar el comando Start-Job, el comando inició realmente tres trabajos independientes en cada uno de los tres equipos. Como consecuencia, el comando devolvió tres objetos de trabajo que representan tres trabajos ejecutados localmente en tres equipos diferentes.

El tercer comando muestra los tres objetos de trabajo en $j. 

El cuarto comando utiliza Invoke-Command para ejecutar un comando Receive-Job en cada una de las PSSessions contenidas en $s y guarda los resultados en la variable $results.

Dado que $j es una variable local, el bloque de script utiliza la palabra clave "param" para declarar las variables en el comando y el parámetro ArgumentList para proporcionar el valor de $j.