Receive-Job

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

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

Receive-Job [-Job] <Job[]> [[-Ort] <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

Beschreibung
-----------
In diesen Befehlen werden die Ergebnisse eines bestimmten Auftrags mit dem Job-Parameter abgerufen. Im ersten Befehl wird mit dem Cmdlet "Start-Job" ein Auftrag gestartet, um den Befehl "Get-Process" auszuführen. Das resultierende Auftragsobjekt wird vom Befehl mit dem Zuweisungsoperator (=) in der Variablen "$job" gespeichert.

Im zweiten Befehl wird das Cmdlet "Receive-Job" verwendet, um die Ergebnisse des Auftrags abzurufen. Der Auftrag wird mit dem Job-Parameter angegeben.

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

C:\PS> $job | receive-job

Beschreibung
-----------
Dieses Beispiel unterscheidet sich vom Beispiel 2 nur darin, dass das Auftragsobjekt vom Befehl mit einem Pipelineoperator (|) an Receive-Job gesendet wird. Aus diesem Grund ist kein Job-Parameter zur Angabe des Auftrags für den Befehl erforderlich.

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

Beschreibung
-----------
In diesen Befehlen werden die Ergebnisse eines von mehreren Hintergrundaufträgen, die auf Remotecomputern ausgeführt werden, mit dem Name-Parameter von Receive-Job abgerufen. 

Im ersten Befehl wird ein Hintergrundauftrag, der auf drei Remotecomputern den Befehl "Get-Service" ausführt, mit dem Cmdlet "Invoke-Command" gestartet. Bei dem Befehl wird der Befehl mithilfe des AsJob-Parameters als Hintergrundauftrag ausgeführt. Mit dem Befehl wird das resultierende Auftragsobjekt in der Variablen "$j" gespeichert.

Wenn Sie einen Auftrag mit dem AsJob-Parameters von Invoke-Command starten, wird das Auftragsobjekt auch dann auf dem lokalen Computer erstellt, wenn der Auftrag auf den Remotecomputern ausgeführt wird. Der Auftrag wird daher mit lokalen Befehlen verwaltet.

Bei Verwendung von AsJob wird außerdem ein Auftragsobjekt von Windows PowerShell zurückgegeben, das einen untergeordneten Auftrag für jeden gestarteten Auftrag enthält. In diesem Fall enthält das Auftragsobjekt drei untergeordnete Aufträge, einen für jeden Auftrag auf jedem Remotecomputer.

Im zweiten Befehl wird mit der DOT-Methode der Wert der ChildJobs-Eigenschaft des Auftragsobjekts in $j angezeigt. Anhand der Anzeige wird deutlich, dass drei untergeordnete Aufträge vom Befehl erstellt wurden, jeweils ein Auftrag für jeden Remotecomputer.
 
Im dritten Befehl werden die Ergebnisse des untergeordneten Auftrags "Job3" mit dem Cmdlet "Receive-Job" abgerufen, der auf dem Computer "Server02" ausgeführt wurde. Der Name des untergeordneten Auftrags wird mit dem Name-Parameter angegeben, und die Auftragsergebnisse werden auch nach Empfang mit dem Name-Parameter gespeichert.

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

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie die Ergebnisse von Hintergrundaufträgen abgerufen werden, die auf Remotecomputern ausgeführt werden.

Im ersten Befehl werden mit dem Cmdlet "New-PSSession" drei PSSessions erstellt, je eine pro angegebenem Server im Befehl. Die PSSessions werden in der Variablen "$s" gespeichert.

Im zweiten Befehl wird mit dem Cmdlet "Invoke-Command" ein Start-Job-Befehl je PSSession in der Variablen "$s"ausgeführt. Der Auftrag führt einen Get-Eventlog-Befehl aus, mit dem die Ereignisse im Systemprotokoll abgerufen werden. Anschließend werden die Ergebnisse in der Variablen "$j" gespeichert.

Da der Befehl "Start-Job" vom Befehl mit Invoke-Command ausgeführt wurde, wurden eigentlich drei unabhängige Aufträge auf jedem der drei Computer gestartet. Daher wurden vom Befehl drei Auftragsobjekte zurückgegeben, die drei Aufträge darstellen, die lokal auf drei verschiedenen Computern ausgeführt werden.

Mit dem dritten Befehl werden die drei Auftragsobjekte in $j angezeigt.  

Der vierte Befehl verwendet Invoke-Command, um einen Receive-Job-Befehl in jeder der PSSessions in $s auszuführen und die Ergebnisse in der Variablen "$results" zu speichern.

Da $j eine lokale Variable darstellt, werden die Variablen im Befehl vom Skriptblock mit dem param-Schlüsselwort deklariert, und der Wert von $j wird mit dem ArgumentList-Parameter angegeben.