Get-Job

Referenz

Modul:: Microsoft.PowerShell.Core

Ruft PowerShell-Hintergrundaufträge ab, die in der aktuellen Sitzung ausgeführt werden.

Syntax

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [[-Id] <Int32[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-State] <JobState>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Name] <String[]>
   [<CommonParameters>]

Get-Job
   [-Filter] <Hashtable>
   [<CommonParameters>]

Beschreibung

Das Get-Job-Cmdlet ruft Objekte ab, die die in der aktuellen Sitzung gestarteten Hintergrundaufträge darstellen. Sie können Get-Job verwenden, um aufträge abzurufen, die mit dem Cmdlet Start-Job oder mit dem AsJob-Parameter eines beliebigen Cmdlets gestartet wurden.

Ohne Parameter ruft ein Get-Job-Befehl alle Aufträge in der aktuellen Sitzung ab. Mithilfe der Parameter von Get-Job können Sie bestimmte Aufträge abrufen.

Das von Get-Job zurückgegebene Auftragsobjekt enthält nützliche Informationen zum Auftrag, aber keine Auftragsergebnisse. Verwenden Sie zum Abrufen der Ergebnisse das Cmdlet Receive-Job.

Ein Windows PowerShell Hintergrundauftrag ist ein Befehl, der im Hintergrund ausgeführt wird, ohne mit der aktuellen Sitzung zu interagieren. In der Regel verwenden Sie einen Hintergrundauftrag, um einen komplexen Befehl auszuführen, der lange dauert. Weitere Informationen zu Hintergrundaufträgen in Windows PowerShell finden Sie unter about_Jobs.

Ab Windows PowerShell 3.0 ruft das Get-Job-Cmdlet auch benutzerdefinierte Auftragstypen ab, wie z. B. Workflowaufträge und Instanzen von geplanten Aufträgen. Zum Ermitteln des Auftragstyps eines Auftrags verwenden Sie die PSJobTypeName-Eigenschaft des Auftrags.

Um Get-Job zum Abrufen eines benutzerdefinierten Auftragstyps zu aktivieren, importieren Sie das Modul, das den benutzerdefinierten Auftragstyp unterstützt, in die Sitzung, bevor Sie einen Get-Job-Befehl ausführen, indem Sie entweder das Cmdlet Import-Module verwenden oder ein Cmdlet im Modul verwenden oder abrufen. Informationen zu einem bestimmten benutzerdefinierten Auftragstyp finden Sie in der Dokumentation der Funktion „Benutzerdefinierte Auftragstypen“.

Beispiele

Beispiel 1: Abrufen aller In der aktuellen Sitzung gestarteten Hintergrundaufträge

PS C:\> Get-Job

Dieser Befehl ruft alle Hintergrundaufträge ab, die in der aktuellen Sitzung gestartet wurden. In anderen Sitzungen erstellte Aufträge sind nicht enthalten, auch wenn die Aufträge auf dem lokalen Computer ausgeführt werden.

Beispiel 2: Beenden eines Auftrags mithilfe einer instance-ID

The first command uses the **Get-Job** cmdlet to get a job. It uses the *Name* parameter to identify the job. The command stores the job object that **Get-Job** returns in the $j variable. In this example, there is only one job with the specified name.
PS C:\> $j = Get-Job -Name Job1

The second command gets the **InstanceId** property of the object in the $j variable and stores it in the $ID variable.
PS C:\> $ID = $j.InstanceID

The third command displays the value of the $ID variable.
PS C:\> $ID

Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55

The fourth command uses Stop-Job cmdlet to stop the job. It uses the *InstanceId* parameter to identify the job and $ID variable to represent the instance ID of the job.
PS C:\> Stop-Job -InstanceId $ID

Diese Befehle zeigen, wie die Instanz-ID eines Auftrags abgerufen und dann zum Beenden eines Auftrags verwendet wird. Im Gegensatz zum Namen eines Auftrags, der nicht eindeutig ist, ist die Instanz-ID eindeutig.

Beispiel 3: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten

PS C:\> Get-Job -Command "*get-process*"

Mit diesem Befehl werden die Aufträge auf dem System abgerufen, die einen Get-Process-Befehl enthalten. Der Befehl verwendet den Command-Parameter von Get-Job, um die abgerufenen Aufträge einzuschränken. Der Befehl verwendet Platzhalterzeichen (*) zum Abrufen von Aufträgen, die einen Get-Process-Befehl an einer beliebigen Stelle in der Befehlszeichenfolge enthalten.

Beispiel 4: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten, mithilfe der Pipeline

PS C:\> "*get-process*" | Get-Job

Wie der Befehl im vorherigen Beispiel ruft dieser Befehl die Aufträge auf dem System ab, die einen Get-Process-Befehl enthalten. Der Befehl verwendet einen Pipelineoperator (|), um eine Zeichenfolge in Anführungszeichen an das Cmdlet Get-Job zu senden. Dies entspricht dem vorherigen Befehl.

Beispiel 5: Abrufen von Aufträgen, die nicht gestartet wurden

PS C:\> Get-Job -State NotStarted

Mit diesem Befehl werden nur die Aufträge abgerufen, die erstellt, aber noch nicht gestartet wurden. Dazu gehören Aufträge, deren Ausführung für einen Zeitpunkt in der Zukunft geplant ist, und solche, die noch nicht geplant wurden.

Beispiel 6: Abrufen von Aufträgen, denen kein Name zugewiesen wurde

PS C:\> Get-Job -Name Job*

Mit diesem Befehl werden alle Aufträge abgerufen, die über Auftragsnamen verfügen, die mit dem Auftrag beginnen. Da die Auftragsnummer<> der Standardname für einen Auftrag ist, ruft dieser Befehl alle Aufträge ab, die keinen explizit zugewiesenen Namen haben.

Beispiel 7: Verwenden eines Auftragsobjekts zum Darstellen des Auftrags in einem Befehl

The first command uses the **Start-Job** cmdlet to start a background job that runs a **Get-Process** command on the local computer. The command uses the *Name* parameter of **Start-Job** to assign a friendly name to the job.
PS C:\> Start-Job -ScriptBlock {Get-Process} -Name MyJob

The second command uses Get-Job to get the job. It uses the *Name* parameter of **Get-Job** to identify the job. The command saves the resulting job object in the $j variable.
PS C:\> $j = Get-Job -Name MyJob

The third command displays the value of the job object in the $j variable. The value of the **State** property shows that the job is completed. The value of the **HasMoreData** property shows that there are results available from the job that have not yet been retrieved.
PS C:\> $j
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
6      MyJob           BackgroundJob   Completed     True            localhost            Get-Process

The fourth command uses the **Receive-Job** cmdlet to get the results of the job. It uses the job object in the $j variable to represent the job. You can also use a pipeline operator to send a job object to **Receive-Job**.
PS C:\> Receive-Job -Job $j
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    124       4    13572      12080    59            1140 audiodg
    783      16    11428      13636   100             548 CcmExec
     96       4     4252       3764    59            3856 ccmsetup
...

Dieses Beispiel veranschaulicht, wie Sie mit Get-Job ein Auftragsobjekt abrufen. Anschließend wird gezeigt, wie Sie mit dem Auftragsobjekt den Auftrag in einem Befehl darstellen.

Beispiel 8: Abrufen aller Aufträge, einschließlich Aufträgen, die mit einer anderen Methode gestartet wurden

The first command uses the **Start-Job** cmdlet to start a job on the local computer.
PS C:\> Start-Job -ScriptBlock {Get-EventLog System}

The second command uses the *AsJob* parameter of the **Invoke-Command** cmdlet to start a job on the S1 computer. Even though the commands in the job run on the remote computer, the job object is created on the local computer, so you use local commands to manage the job.
PS C:\> Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog System} -AsJob

The third command uses the **Invoke-Command** cmdlet to run a **Start-Job** command on the S2 computer. By using this method, the job object is created on the remote computer, so you use remote commands to manage the job.
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}

The fourth command uses **Get-Job** to get the jobs stored on the local computer. The **PSJobTypeName** property of jobs, introduced in Windows PowerShell 3.0, shows that the local job started by using the **Start-Job** cmdlet is a background job and the job started in a remote session by using the **Invoke-Command** cmdlet is a remote job.
PS C:\> Get-Job
Id     Name       PSJobTypeName   State         HasMoreData     Location        Command
--     ----       -------------   -----         -----------     --------        -------
1      Job1       BackgroundJob   Running       True            localhost       Get-EventLog System
2      Job2       RemoteJob       Running       True            S1              Get-EventLog System

The fifth command uses **Invoke-Command** to run a **Get-Job** command on the S2 computer.The sample output shows the results of the Get-Job command. On the S2 computer, the job appears to be a local job. The computer name is localhost and the job type is a background job.For more information about how to run background jobs on remote computers, see about_Remote_Jobs.
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
Id    Name     PSJobTypeName  State      HasMoreData   Location   Command
--    ----     -------------  -----      -----------   -------    -------
4     Job4     BackgroundJob  Running    True          localhost  Get-Eventlog System

In diesem Beispiel wird veranschaulicht, dass das Cmdlet Get-Job alle Aufträge abrufen kann, die in der aktuellen Sitzung gestartet wurden, auch wenn sie mit unterschiedlichen Methoden gestartet wurden.

Beispiel 9: Untersuchen eines fehlerhaften Auftrags

The first command uses the **Start-Job** cmdlet to start a job on the local computer. The job object that **Start-Job** returns shows that the job failed. The value of the **State** property is Failed.
PS C:\> Start-Job -ScriptBlock {Get-Process}
Id     Name       PSJobTypeName   State       HasMoreData     Location             Command
--     ----       -------------   -----       -----------     --------             -------
1      Job1       BackgroundJob   Failed      False           localhost            Get-Process

The second command uses the **Get-Job** cmdlet to get the job. The command uses the dot method to get the value of the **JobStateInfo** property of the object. It uses a pipeline operator to send the object in the **JobStateInfo** property to the Format-List cmdlet, which formats all of the properties of the object (*) in a list.The result of the **Format-List** command shows that the value of the **Reason** property of the job is blank.
PS C:\> (Get-Job).JobStateInfo | Format-List -Property *
State  : Failed
Reason :

The third command investigates more. It uses a **Get-Job** command to get the job and then uses a pipeline operator to send the whole job object to the **Format-List** cmdlet, which displays all of the properties of the job in a list.The display of all properties in the job object shows that the job contains a child job named Job2.
PS C:\> Get-Job | Format-List -Property *
HasMoreData   : False
StatusMessage :
Location      : localhost
Command       : get-process
JobStateInfo  : Failed
Finished      : System.Threading.ManualReset
EventInstanceId    : fb792295-1318-4f5d-8ac8-8a89c5261507
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

The fourth command uses **Get-Job** to get the job object that represents the Job2 child job. This is the job in which the command actually ran. It uses the dot method to get the **Reason** property of the **JobStateInfo** property.The result shows that the job failed because of an Access Denied error. In this case, the user forgot to use the Run as administrator option when starting Windows PowerShell.Because background jobs use the remoting features of Windows PowerShell, the computer must be configured for remoting to run a job, even when the job runs on the local computer.For information about requirements for remoting in Windows PowerShell, see about_Remote_Requirements. For troubleshooting tips, see about_Remote_Troubleshooting.
PS C:\> (Get-Job -Name job2).JobStateInfo.Reason
Connecting to remote server using WSManCreateShellEx api failed. The async callback gave the following error message: Access is denied.

Dieser Befehl zeigt, wie Sie das Auftragsobjekt verwenden, das Get-Job zurückgibt, um zu untersuchen, warum ein Auftrag fehlgeschlagen ist. Weiterhin wird gezeigt, wie die untergeordneten Aufträge der einzelnen Aufträge abgerufen werden.

Beispiel 10: Abrufen gefilterter Ergebnisse

The first command uses the **Workflow** keyword to create the WFProcess workflow.
PS C:\> Workflow WFProcess {Get-Process}

The second command uses the *AsJob* parameter of the WFProcess workflow to run the workflow as a background job. It uses the *JobName* parameter of the workflow to specify a name for the job, and the *PSPrivateMetadata* parameter of the workflow to specify a custom ID.
PS C:\> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}

The third command uses the *Filter* parameter of **Get-Job** to get the job by custom ID that was specified in the *PSPrivateMetadata* parameter.
PS C:\> Get-Job -Filter @{MyCustomId = 92107}
Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
1      WFProcessJob    Completed     True            localhost            WFProcess

Dieses Beispiel zeigt, wie Sie den Filter-Parameter zum Abrufen eines Workflowauftrags verwenden. Der in Windows PowerShell 3.0 eingeführte Filter-Parameter ist nur für benutzerdefinierte Auftragstypen gültig, wie z. B. Workflowaufträge und geplante Aufträge.

Beispiel 11: Abrufen von Informationen zu untergeordneten Aufträgen

The first command gets the jobs in the current session. The output includes a background job, a remote job and several instances of a scheduled job. The remote job, Job4, appears to have failed.
PS C:\> Get-Job
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost            .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02   .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

The second command uses the *IncludeChildJob* parameter of **Get-Job**. The output adds the child jobs of all jobs that have child jobs.In this case, the revised output shows that only the Job5 child job of Job4 failed.
PS C:\> Get-Job -IncludeChildJob
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
3      Job3                            Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
6      Job6                            Completed     True            Server02            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

The third command uses the *ChildJobState* parameter with a value of Failed.The output includes all parent jobs and only the child jobs that failed.
PS C:\> Get-Job -Name Job4 -ChildJobState Failed
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

The fifth command uses the **JobStateInfo** property of jobs and its **Reason** property to discover why Job5 failed.
PS C:\> (Get-Job -Name Job5).JobStateInfo.Reason
Connecting to remote server Server01 failed with the following error message:
Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.

Dieses Beispiel zeigt die Auswirkungen der Verwendung der Parameter IncludeChildJob und ChildJobState des Get-Job-Cmdlets.

Parameter

-After

Ruft abgeschlossene Aufträge ab, die nach dem angegebenen Datum und der angegebenen Uhrzeit beendet wurden. Geben Sie ein DateTime-Objekt ein, z. B. ein vom Cmdlet Get-Date zurückgegebenes Objekt oder eine Zeichenfolge, die in ein DateTime-Objekt konvertiert werden kann, z Dec 1, 2012 2:00 AM . B. oder 11/06.

Dieser Parameter kann nur für benutzerdefinierte Auftragstypen wie z. B. Workflowaufträge und geplante Aufträge verwendet werden, die über eine EndTime-Eigenschaft verfügen. Sie funktioniert nicht bei Standard-Hintergrundaufträgen, z. B. bei aufträgen, die mit dem Cmdlet Start-Job erstellt wurden. Weitere Informationen zur Unterstützung für diesen Parameter finden Sie unter dem Hilfethema für den Auftragstyp.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Before

Ruft abgeschlossene Aufträge ab, die vor dem angegebenen Datum und der angegebenen Uhrzeit beendet wurden. Geben Sie ein DateTime-Objekt ein.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ChildJobState

Ruft nur die untergeordneten Aufträge ab, die den angegebenen Status aufweisen. Zulässige Werte für diesen Parameter:

NotStarted
Wird ausgeführt
Abgeschlossen
Fehler
Beendet
Blockiert
Ausgesetzt
Getrennt
Wird angehalten
Wird beendet

Standardmäßig ruft Get-Job keine untergeordneten Aufträge ab. Mithilfe des IncludeChildJob-Parameters ruft Get-Job alle untergeordneten Aufträge ab. Bei Verwendung des ChildJobState-Parameters hat der IncludeChildJob-Parameter keine Auswirkungen.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

Gibt ein Array von Befehlen als Zeichenfolgen an. Dieses Cmdlet ruft die Aufträge ab, die die angegebenen Befehle enthalten. Standardmäßig werden alle Aufträge fortgesetzt. Sie können Einen Feldhalter verwenden, um ein Befehlsmuster anzugeben.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Filter

Gibt eine Hashtabelle mit Bedingungen an. Dieses Cmdlet ruft Aufträge ab, die alle Bedingungen erfüllen. Geben Sie eine Hashtabelle ein, in der die Schlüssel Auftragseigenschaften und die Werte Werte der Auftragseigenschaften sind.

Dieser Parameter funktioniert nur mit benutzerdefinierten Auftragstypen, z. B. Workflowaufträgen und geplanten Aufträgen. Sie funktioniert nicht bei Standard-Hintergrundaufträgen, z. B. bei aufträgen, die mit dem Cmdlet Start-Job erstellt wurden. Weitere Informationen zur Unterstützung für diesen Parameter finden Sie unter dem Hilfethema für den Auftragstyp.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	Hashtable
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-HasMoreData

Gibt an, ob dieses Cmdlet nur Aufträge erhält, die über den angegebenen HasMoreData-Eigenschaftswert verfügen. Die HasMoreData-Eigenschaft gibt an, ob alle Auftragsergebnisse in der aktuellen Sitzung empfangen wurden. Um Aufträge mit weiteren Ergebnissen abzurufen, geben Sie den Wert $True an. Um Aufträge ohne weitere Ergebnisse abzurufen, geben Sie den Wert $False an.

Verwenden Sie das Cmdlet Receive-Job, um die Ergebnisse eines Auftrags abzurufen.

Wenn Sie das Cmdlet Receive-Job verwenden, löscht es die zurückgegebenen Ergebnisse aus dem sitzungsspezifischen Speicher im Arbeitsspeicher. Wenn alle Ergebnisse des Auftrags in der aktuellen Sitzung zurückgegeben wurden, legt er den Wert der HasMoreData-Eigenschaft des Auftrags auf $False) fest, um anzugeben, dass für den Auftrag in der aktuellen Sitzung keine weiteren Ergebnisse vorliegen. Verwenden Sie den Keep-Parameter von Receive-Job, um zu verhindern, dass Receive-Job Ergebnisse löscht und den Wert der HasMoreData-Eigenschaft ändert. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Receive-Job.

Die HasMoreData-Eigenschaft ist für die aktuelle Sitzung spezifisch. Wenn Ergebnisse für einen benutzerdefinierten Auftragstyp außerhalb der Sitzung gespeichert werden, z. B. der geplante Auftragstyp, der Auftragsergebnisse auf dem Datenträger speichert, können Sie das Cmdlet Receive-Job in einer anderen Sitzung verwenden, um die Auftragsergebnisse erneut abzurufen, auch wenn der Wert von HasMoreData $False ist. Weitere Informationen finden Sie in den Hilfethemen für den benutzerdefinierten Auftragstyp.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Gibt ein Array von IDs von Aufträgen an, die dieses Cmdlet abruft.

Die ID ist eine ganze Zahl, die den Auftrag in der aktuellen Sitzung eindeutig identifiziert. Es ist einfacher zu merken und einzugeben als die instance-ID, aber sie ist nur in der aktuellen Sitzung eindeutig. Sie können eine oder mehrere IDs durch Kommas getrennt eingeben. Geben Sie ohne Parameter ein, Get-Job um die ID eines Auftrags zu finden.

Type:	Int32[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeChildJob

Gibt an, dass dieses Cmdlet neben übergeordneten Aufträgen auch untergeordnete Aufträge zurückgibt.

Dieser Parameter ist besonders nützlich für die Untersuchung von Workflowaufträgen, für die Get-Job einen übergeordneten Containerauftrag zurückgibt, und Auftragsfehler, da der Grund für den Fehler in einer Eigenschaft des untergeordneten Auftrags gespeichert wird.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceId

Gibt ein Array von instance-IDs von Aufträgen an, die dieses Cmdlet abruft. Standardmäßig werden alle Aufträge fortgesetzt.

Eine Instanz-ID ist eine GUID, die den Auftrag auf dem Computer eindeutig identifiziert. Zum Ermitteln der Instanz-ID eines Auftrags verwenden Sie Get-Job.

Type:	Guid[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt ein Array von instance Anzeigenamen von Aufträgen an, die dieses Cmdlet abruft. Geben Sie einen Auftragsnamen ein, oder verwenden Sie Platzhalterzeichen, um ein Auftragsnamensmuster einzugeben. Standardmäßig ruft Get-Job alle Aufträge in der aktuellen Sitzung ab.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Newest

Gibt eine Anzahl von Aufträgen an, die abgerufen werden sollen. Dieses Cmdlet ruft die Aufträge ab, die zuletzt beendet wurden.

Die letzten Aufträge werden vom Newest-Parameter nicht in der Reihenfolge ihrer Endezeit sortiert oder zurückgegeben. Verwenden Sie zum Sortieren der Ausgabe das Cmdlet Sort-Object.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-State

Gibt einen Auftragsstatus an. Dieses Cmdlet ruft nur Aufträge im angegebenen Zustand ab. Zulässige Werte für diesen Parameter:

NotStarted
Wird ausgeführt
Abgeschlossen
Fehler
Beendet
Blockiert
Ausgesetzt
Getrennt
Wird angehalten
Wird beendet

Standardmäßig ruft Get-Job alle Aufträge in der aktuellen Sitzung ab.

Weitere Informationen zu Auftragszuständen finden Sie unter JobState Enumeration in der MSDN Library.

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Eingaben

None

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

System.Management.Automation.RemotingJob

Dieses Cmdlet gibt Objekte zurück, die die Aufträge in der Sitzung darstellen.

Hinweise

Die PSJobTypeName-Eigenschaft von Aufträgen gibt den Auftragstyp des Auftrags an. Der Eigenschaftswert wird vom Autor des Auftragstyps bestimmt. Die folgende Liste enthält allgemeine Auftragstypen.
- BackgroundJob. Lokaler Auftrag, der mit Start-Job gestartet wurde.
- RemoteJob. Der Auftrag wurde in einer PSSession mithilfe des AsJob-Parameters des Cmdlets Invoke-Command gestartet.
- PSWorkflowJob. Auftrag, der mit dem allgemeinen AsJob-Parameter von Workflows gestartet wurde.

Freigeben über

Get-Job

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen aller In der aktuellen Sitzung gestarteten Hintergrundaufträge

Beispiel 2: Beenden eines Auftrags mithilfe einer instance-ID

Beispiel 3: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten

Beispiel 4: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten, mithilfe der Pipeline

Beispiel 5: Abrufen von Aufträgen, die nicht gestartet wurden

Beispiel 6: Abrufen von Aufträgen, denen kein Name zugewiesen wurde

Beispiel 7: Verwenden eines Auftragsobjekts zum Darstellen des Auftrags in einem Befehl

Beispiel 8: Abrufen aller Aufträge, einschließlich Aufträgen, die mit einer anderen Methode gestartet wurden

Beispiel 9: Untersuchen eines fehlerhaften Auftrags

Beispiel 10: Abrufen gefilterter Ergebnisse

Beispiel 11: Abrufen von Informationen zu untergeordneten Aufträgen

Parameter

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Eingaben

Ausgaben

Hinweise

Zusätzliche Ressourcen

Freigeben über

Get-Job

Syntax

Beschreibung

Beispiele

Beispiel 1: Abrufen aller In der aktuellen Sitzung gestarteten Hintergrundaufträge

Beispiel 2: Beenden eines Auftrags mithilfe einer instance-ID

Beispiel 3: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten

Beispiel 4: Abrufen von Aufträgen, die einen bestimmten Befehl enthalten, mithilfe der Pipeline

Beispiel 5: Abrufen von Aufträgen, die nicht gestartet wurden

Beispiel 6: Abrufen von Aufträgen, denen kein Name zugewiesen wurde

Beispiel 7: Verwenden eines Auftragsobjekts zum Darstellen des Auftrags in einem Befehl

Beispiel 8: Abrufen aller Aufträge, einschließlich Aufträgen, die mit einer anderen Methode gestartet wurden

Beispiel 9: Untersuchen eines fehlerhaften Auftrags

Beispiel 10: Abrufen gefilterter Ergebnisse

Beispiel 11: Abrufen von Informationen zu untergeordneten Aufträgen

Parameter

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Zusätzliche Ressourcen