Wait-Job

Wait-Job
    [-Id] <Int32[]>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Wait-Job
    [-Job] <Job[]>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Wait-Job
    [-Name] <String[]>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Wait-Job
    [-InstanceId] <Guid[]>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Wait-Job
    [-State] <JobState>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Wait-Job
    [-Filter] <Hashtable>
    [-Any]
    [-Timeout <Int32>]
    [-Force]
    [<CommonParameters>]

Das Cmdlet Wait-Job wartet, bis ein Prozess in einem abschließenden Zustand ist, bevor die Ausführung fortgesetzt wird. Die Endzustände sind:

• Abgeschlossen
• gescheitert
• Angehalten
• Suspendiert
• Getrennt

Sie können warten, bis sich ein bestimmter Job oder alle Jobs in einem beendenden Status befinden. Sie können auch eine maximale Wartezeit für den Auftrag mithilfe des Timeout--Parameters festlegen oder den Parameter Force verwenden, um auf einen Auftrag im Suspended- oder Disconnected-Status zu warten.

Wenn die Befehle im Auftrag abgeschlossen sind, gibt Wait-Job ein Auftragsobjekt zurück und setzt die Ausführung fort.

Sie können das Cmdlet Wait-Job verwenden, um auf Aufträge zu warten, die mit dem Cmdlet Start-Job oder dem Parameter AsJob des Cmdlets Invoke-Command gestartet wurden. Weitere Informationen zu Aufträgen finden Sie unter Informationen zu Aufträgen.

Ab Windows PowerShell 3.0 wartet das cmdlet Wait-Job auch auf benutzerdefinierte Auftragstypen, z. B. Workflowaufträge und Instanzen geplanter Aufträge. Damit Wait-Job auf Aufträge eines bestimmten Typs warten können, importieren Sie das Modul, das den benutzerdefinierten Auftragstyp unterstützt, in die Sitzung, bevor Sie das cmdlet Get-Job ausführen, entweder mithilfe des Cmdlets Import-Module oder mithilfe oder Abrufen eines Cmdlets im Modul. Informationen zu einem bestimmten benutzerdefinierten Auftragstyp finden Sie in der Dokumentation des Features für den benutzerdefinierten Auftragstyp.

Get-Job | Wait-Job

Dieser Befehl wartet darauf, dass alle in der Sitzung ausgeführten Aufträge beendet werden.

$s = New-PSSession Server01, Server02, Server03
Invoke-Command -Session $s -ScriptBlock {Start-Job -Name Date1 -ScriptBlock {Get-Date}}
$done = Invoke-Command -Session $s -Command {Wait-Job -Name Date1}
$done.Count

3

In diesem Beispiel wird gezeigt, wie Sie das cmdlet Wait-Job mit Aufträgen verwenden, die auf Remotecomputern mithilfe des Cmdlets Start-Job gestartet wurden. Befehle Start-Job und Wait-Job werden mithilfe des cmdlets Invoke-Command an den Remotecomputer übermittelt.

In diesem Beispiel wird Wait-Job verwendet, um zu bestimmen, ob ein Get-Date Befehl, der als Auftrag auf drei verschiedenen Computern ausgeführt wird, abgeschlossen ist.

Der erste Befehl erstellt eine Windows PowerShell-Sitzung (PSSession) auf jedem der drei Remotecomputer und speichert sie in der $s Variablen.

Der zweite Befehl verwendet Invoke-Command, um Start-Job in jeder der drei Sitzungen in $sauszuführen. Alle Jobs haben den Namen Date1.

Der dritte Befehl verwendet Invoke-Command, um Wait-Jobauszuführen. Dieser Befehl wartet darauf, dass die Date1 Jobs auf jedem Computer beendet werden. Sie speichert die resultierende Auflistung (Array) von Job Objekten in die $done Variable.

Der vierte Befehl verwendet die eigenschaft Count des Arrays von Auftragsobjekten in der variablen $done, um zu bestimmen, wie viele der Aufträge abgeschlossen sind.

$s = New-PSSession -ComputerName (Get-Content -Path .\Machines.txt)
$c = 'Get-EventLog -LogName System | Where-Object {$PSItem.EntryType -eq "error" --and $PSItem.Source -eq "LSASRV"} | Out-File -FilePath Errors.txt'
Invoke-Command -Session $s -ScriptBlock {Start-Job -ScriptBlock {$Using:c}
Invoke-Command -Session $s -ScriptBlock {Wait-Job -Any}

In diesem Beispiel wird der Parameter Any von Wait-Job verwendet, um festzustellen, wann der erste von vielen Jobs, die in der aktuellen Sitzung ausgeführt werden, sich in einem terminierenden Status befindet. Außerdem wird gezeigt, wie Sie mit dem Cmdlet Wait-Job warten, bis Remoteaufträge abgeschlossen sind.

Der erste Befehl erstellt eine PSSession- auf jedem der in der Machines.txt Datei aufgeführten Computer und speichert die PSSession- Objekte in der variablen $s. Der Befehl verwendet das Cmdlet Get-Content, um den Inhalt der Datei abzurufen. Der Befehl Get-Content wird in Klammern eingeschlossen, um sicherzustellen, dass er vor dem Befehl New-PSSession ausgeführt wird.

Der zweite Befehl speichert eine Get-EventLog Befehlszeichenfolge in Anführungszeichen in der variablen $c.

Der dritte Befehl verwendet Invoke-Command Cmdlet, um Start-Job in den einzelnen Sitzungen in $sauszuführen. Der Befehl Start-Job startet einen Auftrag, der den Befehl Get-EventLog in der variablen $c ausführt.

Der Befehl verwendet den Using: Bereichsmodifizierer, um anzugeben, dass die $c Variable auf dem lokalen Computer definiert wurde. Der Using: Bereichsmodifizierer wird in Windows PowerShell 3.0 eingeführt. Weitere Informationen zum Using: Bereichsmodifizierer finden Sie unter about_Remote_Variables.

Der vierte Befehl verwendet "Invoke-Command", um einen "Wait-Job" Befehl in den Sitzungen auszuführen. Er verwendet den Parameter Any, um zu warten, bis der erste Job auf den Remote-Computern den Status terminating hat.

PS> $s = New-PSSession -ComputerName Server01, Server02, Server03
PS> $jobs = Invoke-Command -Session $s -ScriptBlock {Start-Job -ScriptBlock {Get-Date}}
PS> $done = Invoke-Command -Session $s -ScriptBlock {Wait-Job -Timeout 30}
PS>

In diesem Beispiel wird gezeigt, wie Sie den Timeout Parameter von Wait-Job verwenden, um eine maximale Wartezeit für die Aufträge festzulegen, die auf Remotecomputern ausgeführt werden.

Der erste Befehl erstellt eine PSSession- auf jedem der drei Remotecomputer (Server01, Server02 und Server03) und speichert dann die PSSession- Objekte in der $s Variablen.

Der zweite Befehl verwendet Invoke-Command, um Start-Job in jedem der PSSession- Objekte in $sauszuführen. Es speichert die resultierenden Auftragsobjekte in der $jobs Variablen.

Der dritte Befehl verwendet Invoke-Command, um Wait-Job in jeder Sitzung in $sauszuführen. Der Befehl Wait-Job bestimmt, ob alle Befehle innerhalb von 30 Sekunden abgeschlossen wurden. Er verwendet den Timeout--Parameter mit dem Wert 30, um die maximale Wartezeit festzulegen, und speichert dann die Ergebnisse des Befehls in der $done Variablen.

In diesem Fall ist nach 30 Sekunden nur der Befehl auf dem Server02-Computer abgeschlossen. Wait-Job beendet die Wartezeit, gibt das Objekt zurück, das den abgeschlossenen Auftrag darstellt, und zeigt die Eingabeaufforderung an.

Die variable $done enthält ein Auftragsobjekt, das den Auftrag darstellt, der auf Server02 ausgeführt wurde.

Wait-Job -Id 1, 2, 5 -Any

Mit diesem Befehl werden drei Aufträge anhand ihrer IDs identifiziert und gewartet, bis sich eins dieser Aufträge in einem Beendigungszustand befindet. Die Ausführung wird fortgesetzt, wenn der erste Auftrag abgeschlossen ist.

Wait-Job -Name "DailyLog" -Timeout 120

Dieser Befehl wartet 120 Sekunden (zwei Minuten), bis der DailyLog-Auftrag abgeschlossen ist. Wenn der Auftrag in den nächsten zwei Minuten nicht abgeschlossen wird, wird die Ausführung fortgesetzt, und der Auftrag wird weiterhin im Hintergrund ausgeführt.

Wait-Job -Name "Job3"

Dieser Befehl verwendet den Auftragsnamen, um den Auftrag zu identifizieren, für den gewartet werden soll.

$j = Start-Job -ScriptBlock {Get-ChildItem -Filter *.ps1 | Where-Object {$PSItem.LastWriteTime -gt ((Get-Date) - (New-TimeSpan -Days 7))}}
$j | Wait-Job

In diesem Beispiel wird gezeigt, wie Sie das Cmdlet Wait-Job mit Aufträgen verwenden, die mit Start-Jobauf dem lokalen Computer gestartet wurden.

Diese Befehle starten einen Auftrag, der die Windows PowerShell-Skriptdateien abruft, die in der letzten Woche hinzugefügt oder aktualisiert wurden.

Der erste Befehl verwendet Start-Job, um einen Auftrag auf dem lokalen Computer zu starten. Der Auftrag führt einen Get-ChildItem Befehl aus, der alle Dateien mit einer .ps1 Dateinamenerweiterung abruft, die in der letzten Woche hinzugefügt oder aktualisiert wurden.

Der dritte Befehl verwendet Wait-Job, um zu warten, bis sich der Job in einem Terminierungsstatus befindet. Nach Abschluss des Auftrags zeigt der Befehl das Auftragsobjekt an, das Informationen zum Auftrag enthält.

$s = New-PSSession -ComputerName Server01, Server02, Server03
$j = Invoke-Command -Session $s -ScriptBlock {Get-Process} -AsJob
$j | Wait-Job

In diesem Beispiel wird gezeigt, wie Sie Wait-Job mit Aufträgen verwenden, die auf Remotecomputern gestartet wurden, indem Sie den Parameter AsJob von Invoke-Commandverwenden. Wenn Sie AsJobverwenden, wird der Auftrag auf dem lokalen Computer erstellt, und die Ergebnisse werden automatisch an den lokalen Computer zurückgegeben, obwohl der Auftrag auf den Remotecomputern ausgeführt wird.

In diesem Beispiel wird Wait-Job verwendet, um zu bestimmen, ob ein Get-Process Befehl, der in den Sitzungen auf drei Remotecomputern ausgeführt wird, in einem Beendigungszustand liegt.

Der erste Befehl erstellt PSSession- Objekte auf drei Computern und speichert sie in der $s Variablen.

Der zweite Befehl verwendet Invoke-Command, um Get-Process in jeder der drei Sitzungen in $sauszuführen. Der Befehl verwendet den AsJob Parameter, um den Befehl asynchron als Auftrag auszuführen. Der Befehl gibt ein Auftragsobjekt zurück, genau wie die Aufträge, die mit Start-Jobgestartet wurden, und das Auftragsobjekt wird in der variablen $j gespeichert.

Der dritte Befehl verwendet einen Pipelineoperator (|), um das Auftragsobjekt in $j an das Cmdlet Wait-Job zu senden. In diesem Fall ist kein Invoke-Command-Befehl erforderlich, da sich der Auftrag auf dem lokalen Computer befindet.

Get-Job

Id   Name     State      HasMoreData     Location             Command
--   ----     -----      -----------     --------             -------
1    Job1     Completed  True            localhost,Server01.. Get-Service
4    Job4     Completed  True            localhost            dir | where

Wait-Job -Id 1

Dieser Befehl wartet auf den Auftrag mit dem ID-Wert 1.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können ein Auftragsobjekt an dieses Cmdlet weiterleiten.

Dieses Cmdlet gibt Auftragsobjekte zurück, die die Aufträge in einem Beendigungszustand darstellen. Wenn die Wartezeit endet, weil der Wert des Timeout Parameter überschritten wird, gibt Wait-Job keine Objekte zurück.

PowerShell enthält die folgenden Aliase für Wait-Job:

• Alle Plattformen:
  • wjb

Standardmäßig kehrt Wait-Job zurück oder beendet das Warten, wenn sich Jobs in einem der folgenden Status befinden:

• Abgeschlossen
• gescheitert
• Angehalten
• Suspendiert
• Getrennt

Um Wait-Job anzuweisen, weiterhin auf angehaltene und unterbrochene Jobs zu warten, verwenden Sie den Parameter Force.