Get-Job
Hiermee haalt u PowerShell-achtergrondtaken op die worden uitgevoerd in de huidige sessie.
Syntax
SessionIdParameterSet (Standaard)
Get-Job
[[-Id] <Int32[]>]
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
StateParameterSet
Get-Job
[-State] <JobState>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
CommandParameterSet
Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-Command <String[]>]
[<CommonParameters>]
InstanceIdParameterSet
Get-Job
[-InstanceId] <Guid[]>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
NameParameterSet
Get-Job
[-Name] <String[]>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
FilterParameterSet
Get-Job
[-Filter] <Hashtable>
[<CommonParameters>]
Description
De cmdlet Get-Job haalt objecten op die de achtergrondtaken vertegenwoordigen die zijn gestart in de huidige sessie. U kunt Get-Job- gebruiken om taken op te halen die zijn gestart met behulp van de cmdlet Start-Job of met behulp van de parameter AsJob van een cmdlet.
Zonder parameters haalt een opdracht Get-Job alle taken in de huidige sessie op. U kunt de parameters van Get-Job- gebruiken om bepaalde taken op te halen.
Het taakobject dat Get-Job retourneert, bevat nuttige informatie over de taak, maar bevat geen taakresultaten. Gebruik de cmdlet Receive-Job om de resultaten op te halen.
Een Windows PowerShell-achtergrondtaak is een opdracht die op de achtergrond wordt uitgevoerd zonder interactie met de huidige sessie. Normaal gesproken gebruikt u een achtergrondtaak om een complexe opdracht uit te voeren die lang duurt om te voltooien. Zie about_Jobs voor meer informatie over achtergrondtaken in Windows PowerShell.
Vanaf Windows PowerShell 3.0 krijgt de cmdlet Get-Job ook aangepaste taaktypen, zoals werkstroomtaken en exemplaren van geplande taken. Als u het taaktype van een taak wilt vinden, gebruikt u de eigenschap PSJobTypeName van de taak.
Als u Get-Job- wilt inschakelen om een aangepast taaktype op te halen, importeert u de module die het aangepaste taaktype ondersteunt in de sessie voordat u een opdracht Get-Job uitvoert, hetzij met behulp van de Import-Module-cmdlet of door een cmdlet in de module te gebruiken of op te halen. Raadpleeg de documentatie van de functie voor aangepaste taaktypen voor informatie over een specifiek type aangepaste taak.
Voorbeelden
Voorbeeld 1: Alle achtergrondtaken starten in de huidige sessie
PS C:\> Get-Job
Met deze opdracht worden alle achtergrondtaken gestart in de huidige sessie. Het bevat geen taken die zijn gemaakt in andere sessies, zelfs als de taken worden uitgevoerd op de lokale computer.
Voorbeeld 2: Een taak stoppen met behulp van een exemplaar-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
Deze opdrachten laten zien hoe u de exemplaar-id van een taak opgeeft en deze vervolgens gebruikt om een taak te stoppen. In tegenstelling tot de naam van een taak, die niet uniek is, is de exemplaar-id uniek.
Voorbeeld 3: Taken ophalen die een specifieke opdracht bevatten
PS C:\> Get-Job -Command "*get-process*"
Met deze opdracht worden de taken op het systeem met een Get-Process opdracht. De opdracht gebruikt de Command parameter van Get-Job om de opgehaalde taken te beperken. De opdracht maakt gebruik van jokertekens (*) om taken op te halen die een Get-Process opdracht overal in de opdrachtreeks bevatten.
Voorbeeld 4: Taken ophalen die een specifieke opdracht bevatten met behulp van de pijplijn
PS C:\> "*get-process*" | Get-Job
Net als bij de opdracht in het vorige voorbeeld worden met deze opdracht de taken op het systeem met een opdracht Get-Process. De opdracht maakt gebruik van een pijplijnoperator (|) om een tekenreeks tussen aanhalingstekens te verzenden naar de cmdlet Get-Job. Dit is het equivalent van de vorige opdracht.
Voorbeeld 5: Taken ophalen die niet zijn gestart
PS C:\> Get-Job -State NotStarted
Met deze opdracht worden alleen taken weergegeven die zijn gemaakt, maar die nog niet zijn gestart. Dit omvat taken die in de toekomst moeten worden uitgevoerd en taken die nog niet zijn gepland.
Voorbeeld 6: Taken ophalen waaraan geen naam is toegewezen
PS C:\> Get-Job -Name Job*
Met deze opdracht krijgt u alle taken met jobnamen die beginnen met job. Omdat de taak<nummer> de standaardnaam voor een taak is, worden met deze opdracht alle taken opgehaald waarvoor geen expliciete naam is toegewezen.
Voorbeeld 7: Een taakobject gebruiken om de taak in een opdracht weer te geven
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
...
In dit voorbeeld ziet u hoe u Get-Job- gebruikt om een taakobject op te halen. Vervolgens ziet u hoe u het taakobject gebruikt om de taak in een opdracht weer te geven.
Voorbeeld 8: Alle taken ophalen, inclusief taken die zijn gestart met een andere methode
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 dit voorbeeld ziet u dat de cmdlet Get-Job alle taken kan ophalen die in de huidige sessie zijn gestart, zelfs als ze zijn gestart met behulp van verschillende methoden.
Voorbeeld 9: Een mislukte taak onderzoeken
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.
Deze opdracht laat zien hoe u het taakobject gebruikt dat Get-Job retourneert om te onderzoeken waarom een taak is mislukt. Ook ziet u hoe u de onderliggende taken van elke taak kunt ophalen.
Voorbeeld 10: Gefilterde resultaten ophalen
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
In dit voorbeeld ziet u hoe u de parameter Filter gebruikt om een werkstroomtaak op te halen. De parameter Filter, geïntroduceerd in Windows PowerShell 3.0, is alleen geldig voor aangepaste taaktypen, zoals werkstroomtaken en geplande taken.
Voorbeeld 11: Informatie over onderliggende taken ophalen
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.
In dit voorbeeld ziet u het effect van het gebruik van de parameters IncludeChildJob en ChildJobState parameters van de cmdlet Get-Job.
Parameters
-After
Hiermee worden voltooide taken geretourneerd die na de opgegeven datum en tijd zijn beëindigd.
Voer een DateTime--object in, zoals een object dat wordt geretourneerd door de Get-Date-cmdlet of een tekenreeks die kan worden geconverteerd naar een DateTime--object, zoals Dec 1, 2012 2:00 AM of 11/06.
Deze parameter werkt alleen voor aangepaste taaktypen, zoals werkstroomtaken en geplande taken, met een eigenschap EndTime. Het werkt niet voor standaardachtergrondtaken, zoals taken die zijn gemaakt met behulp van de cmdlet Start-Job. Zie het Help-onderwerp voor het taaktype voor informatie over ondersteuning voor deze parameter.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | DateTime |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Before
Hiermee worden voltooide taken geretourneerd die vóór de opgegeven datum en tijd zijn beëindigd. Voer een DateTime--object in.
Deze parameter werkt alleen voor aangepaste taaktypen, zoals werkstroomtaken en geplande taken, met een eigenschap EndTime. Het werkt niet voor standaardachtergrondtaken, zoals taken die zijn gemaakt met behulp van de cmdlet Start-Job. Zie het Help-onderwerp voor het taaktype voor informatie over ondersteuning voor deze parameter.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | DateTime |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ChildJobState
Hiermee haalt u alleen de onderliggende taken op met de opgegeven status. De acceptabele waarden voor deze parameter zijn:
- Niet gestart
- Hardlopen
- Volbracht
- Mislukt
- Gestopt
- Geblokkeerd
- Opgeschort
- Niet verbonden
- Onderbreken
- Het stoppen
Standaard krijgt Get-Job- geen onderliggende taken. Met de parameter IncludeChildJob krijgt Get-Job alle onderliggende taken. Als u de parameter ChildJobState gebruikt, heeft de parameter IncludeChildJob geen effect.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | JobState |
| Default value: | None |
| Geaccepteerde waarden: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Command
Hiermee geeft u een matrix van opdrachten als tekenreeksen. Met deze cmdlet worden de taken ophaalt die de opgegeven opdrachten bevatten. De standaardwaarde is alle taken. U kunt jokertekens gebruiken om een opdrachtpatroon op te geven.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Filter
Hiermee geeft u een hash-tabel met voorwaarden. Met deze cmdlet worden taken ophaalt die voldoen aan alle voorwaarden. Voer een hashtabel in waarin de sleutels taakeigenschappen zijn en de waarden taakeigenschapswaarden zijn.
Deze parameter werkt alleen voor aangepaste taaktypen, zoals werkstroomtaken en geplande taken. Het werkt niet voor standaardachtergrondtaken, zoals taken die zijn gemaakt met behulp van de cmdlet Start-Job. Zie het Help-onderwerp voor het taaktype voor informatie over ondersteuning voor deze parameter.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | Hashtable |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
FilterParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-HasMoreData
Geeft aan of deze cmdlet alleen taken krijgt met de opgegeven HasMoreData eigenschapswaarde. De eigenschap HasMoreData geeft aan of alle taakresultaten zijn ontvangen in de huidige sessie. Als u taken met meer resultaten wilt ophalen, geeft u een waarde van $True op. Als u taken wilt ophalen die niet meer resultaten hebben, geeft u een waarde van $False op.
Gebruik de cmdlet Receive-Job om de resultaten van een taak op te halen.
Wanneer u de cmdlet Receive-Job gebruikt, worden de resultaten die zijn geretourneerd uit de in-memory, sessiespecifieke opslag verwijderd.
Wanneer alle resultaten van de taak in de huidige sessie zijn geretourneerd, wordt de waarde van de eigenschap HasMoreData van de taak ingesteld op $False) om aan te geven dat deze geen resultaten meer heeft voor de taak in de huidige sessie.
Gebruik de parameter Keep van Receive-Job om te voorkomen dat Receive-Job- resultaten verwijdert en de waarde van de eigenschap HasMoreData wijzigt.
Typ Get-Help Receive-Jobvoor meer informatie.
De eigenschap HasMoreData is specifiek voor de huidige sessie. Als resultaten voor een aangepast taaktype buiten de sessie worden opgeslagen, zoals het geplande taaktype, waarmee taakresultaten op schijf worden opgeslagen, kunt u de cmdlet Receive-Job in een andere sessie gebruiken om de taakresultaten opnieuw op te halen, zelfs als de waarde van HasMoreData- is $False. Zie de Help-onderwerpen voor het aangepaste taaktype voor meer informatie.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Id
Hiermee geeft u een matrix van id's van taken op die door deze cmdlet worden opgehaald.
De id is een geheel getal dat de taak in de huidige sessie uniek identificeert.
Het is gemakkelijker om te onthouden en te typen dan de exemplaar-id, maar het is alleen uniek in de huidige sessie.
U kunt een of meer id's typen, gescheiden door komma's.
Als u de id van een taak wilt vinden, typt u Get-Job zonder parameters.
Parametereigenschappen
| Type: | Int32[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-IncludeChildJob
Geeft aan dat deze cmdlet onderliggende taken retourneert, naast bovenliggende taken.
Deze parameter is vooral handig voor het onderzoeken van werkstroomtaken, waarvoor Get-Job- een bovenliggende containertaak retourneert en taakfouten, omdat de reden voor de fout wordt opgeslagen in een eigenschap van de onderliggende taak.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-InstanceId
Hiermee geeft u een matrix op van exemplaar-id's van taken die door deze cmdlet worden opgehaald. De standaardwaarde is alle taken.
Een exemplaar-id is een GUID waarmee de taak op de computer uniek wordt geïdentificeerd. Gebruik Get-Jobom de exemplaar-id van een taak te vinden.
Parametereigenschappen
| Type: | Guid[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
InstanceIdParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u een matrix op van instantievriendelijke namen van taken die door deze cmdlet worden ophaalt. Voer een taaknaam in of gebruik jokertekens om een taaknaampatroon in te voeren. Get-Job krijgt standaard alle taken in de huidige sessie.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Newest
Hiermee geeft u een aantal taken te verkrijgen. Deze cmdlet haalt de taken op die het laatst zijn beëindigd.
De parameter Nieuwste sorteert of retourneert de nieuwste taken niet in de eindtijdvolgorde. Als u de uitvoer wilt sorteren, gebruikt u de cmdlet Sort-Object.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SessionIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
StateParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommandParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
InstanceIdParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-State
Bepaalt een taakstatus. Met deze cmdlet worden alleen taken met de opgegeven status opgeslagen. De acceptabele waarden voor deze parameter zijn:
- Niet gestart
- Hardlopen
- Volbracht
- Mislukt
- Gestopt
- Geblokkeerd
- Opgeschort
- Niet verbonden
- Onderbreken
- Het stoppen
Standaard haalt Get-Job alle taken in de huidige sessie op.
Zie JobState-opsomming in de MSDN-bibliotheek voor meer informatie over taakstatussen.
Parametereigenschappen
| Type: | JobState |
| Default value: | None |
| Geaccepteerde waarden: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
StateParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
U kunt invoer voor deze cmdlet niet doorsluisen.
Uitvoerwaarden
System.Management.Automation.RemotingJob
Met deze cmdlet worden objecten geretourneerd die de taken in de sessie vertegenwoordigen.
Notities
De eigenschap PSJobTypeName van taken geeft het taaktype van de taak aan. De eigenschapswaarde wordt bepaald door de auteur van het taaktype. De volgende lijst bevat algemene taaktypen.
AchtergrondJob. Lokale taak is gestart met starttaak.
Werk op afstand. De taak is gestart in een PSSession- met behulp van de parameter AsJob van de Invoke-Command-cmdlet.
PSWorkflowJob. Taak is gestart met behulp van de AsJob algemene parameter van werkstromen.