about_Jobs
Korte beschrijving
Biedt informatie over hoe PowerShell-achtergrondtaken een opdracht of expressie op de achtergrond uitvoeren zonder interactie met de huidige sessie.
Lange beschrijving
PowerShell voert gelijktijdig opdrachten en scripts uit via taken. PowerShell biedt drie typen taken ter ondersteuning van gelijktijdigheid.
RemoteJob- Opdrachten en scripts worden uitgevoerd op een externe sessie. Zie about_Remote_Jobs voor meer informatie.BackgroundJob- Opdrachten en scripts worden uitgevoerd in een afzonderlijk proces op de lokale computer.PSTaskJobofThreadJob- Opdrachten en scripts worden uitgevoerd in een afzonderlijke thread binnen hetzelfde proces op de lokale computer. Zie about_Thread_Jobs voor meer informatie.
Het extern uitvoeren van scripts, op een afzonderlijke computer of in een afzonderlijk proces, biedt een goede isolatie. Fouten die optreden in de externe taak, zijn niet van invloed op andere actieve taken of de bovenliggende sessie die de taak heeft gestart. De externe laag voegt echter overhead toe, inclusief objectserialisatie. Alle objecten worden geserialiseerd en gedeserialiseerd wanneer ze worden doorgegeven tussen de bovenliggende sessie en de externe (taak)-sessie. Serialisatie van grote complexe gegevensobjecten kan grote hoeveelheden reken- en geheugenresources verbruiken en grote hoeveelheden gegevens overdragen via het netwerk.
Thread-taken zijn niet zo robuust als externe en achtergrondtaken, omdat ze in hetzelfde proces op verschillende threads worden uitgevoerd. Als een taak een kritieke fout heeft die het proces vastloopt, worden alle andere taken in het proces beëindigd.
Voor threadgebaseerde taken is echter minder overhead vereist. Ze maken geen gebruik van de externe laag of serialisatie. De resultaatobjecten worden geretourneerd als verwijzingen naar live-objecten in de huidige sessie. Zonder deze overhead worden threadtaken sneller uitgevoerd en worden er minder resources gebruikt dan de andere taaktypen.
Belangrijk
De bovenliggende sessie die de taak heeft gemaakt, bewaakt ook de taakstatus en verzamelt pijplijngegevens. Het onderliggende taakproces wordt beëindigd door het bovenliggende proces zodra de taak een voltooide status heeft bereikt. Als de bovenliggende sessie wordt beëindigd, worden alle actieve onderliggende taken samen met hun onderliggende processen beëindigd.
Er zijn twee manieren om deze situatie te omzeilen:
- Gebruik
Invoke-Commanddit om taken te maken die worden uitgevoerd in niet-verbonden sessies. Zie about_Remote_Jobs voor meer informatie. - Gebruik
Start-Processdit om een nieuw proces te maken in plaats van een taak. Zie Start-Process voor meer informatie.
De taak-cmdlets
Start-Job- Hiermee start u een achtergrondtaak op een lokale computer.Get-Job- Haalt de achtergrondtaken op die zijn gestart in de huidige sessie.Receive-Job- Haalt de resultaten van achtergrondtaken op.Stop-Job- Stopt een achtergrondtaak.Wait-Job- Onderdrukt de opdrachtprompt totdat een of alle taken zijn voltooid.Remove-Job- Hiermee verwijdert u een achtergrondtaak.Invoke-Command- Met de parameter AsJob maakt u een achtergrondtaak op een externe computer. U kunt elkeInvoke-Commandtaakopdracht op afstand uitvoeren, inclusiefStart-Job.
Een taak starten op de lokale computer
Gebruik de Start-Job cmdlet om een achtergrondtaak op de lokale computer te starten.
Als u een Start-Job opdracht wilt schrijven, plaatst u de opdracht die door de taak wordt uitgevoerd in accolades ({}). Gebruik de parameter ScriptBlock om de opdracht op te geven.
Met de volgende opdracht wordt een achtergrondtaak gestart waarmee een Get-Process opdracht op de lokale computer wordt uitgevoerd.
Start-Job -ScriptBlock {Get-Process}
Wanneer u een achtergrondtaak start, wordt de opdrachtprompt onmiddellijk geretourneerd, zelfs als het langer duurt voordat de taak is voltooid. U kunt zonder onderbreking in de sessie blijven werken terwijl de taak wordt uitgevoerd.
De Start-Job opdracht retourneert een object dat de taak vertegenwoordigt. Het taakobject bevat nuttige informatie over de taak, maar bevat geen taakresultaten.
U kunt het taakobject opslaan in een variabele en dit vervolgens gebruiken met de andere taak-cmdlets om de achtergrondtaak te beheren. Met de volgende opdracht wordt een taakobject gestart en wordt het resulterende taakobject opgeslagen in de $job variabele.
$job = Start-Job -ScriptBlock {Get-Process}
Vanaf PowerShell 6.0 kunt u de achtergrondoperator (&) aan het einde van een pijplijn gebruiken om een achtergrondtaak te starten. Zie de achtergrondoperator voor meer informatie.
Het gebruik van de achtergrondoperator is functioneel gelijk aan het gebruik van de Start-Job cmdlet in het vorige voorbeeld.
$job = Get-Process &
Taakobjecten verkrijgen
De Get-Job cmdlet retourneert objecten die de achtergrondtaken vertegenwoordigen die zijn gestart in de huidige sessie. Zonder parameters Get-Job worden alle taken geretourneerd die zijn gestart in de huidige sessie.
Get-Job
Het taakobject bevat de status van de taak, die aangeeft of de taak is voltooid. Een voltooide taak heeft de status Voltooid of Mislukt. Een taak kan ook worden geblokkeerd of uitgevoerd.
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
U kunt het taakobject opslaan in een variabele en dit gebruiken om de taak in een latere opdracht weer te geven. Met de volgende opdracht wordt de taak met id 1 opgeslagen en opgeslagen in de $job variabele.
$job = Get-Job -Id 1
De resultaten van een taak ophalen
Wanneer u een achtergrondtaak uitvoert, worden de resultaten niet onmiddellijk weergegeven. Gebruik de cmdlet om de resultaten van een achtergrondtaak op te Receive-Job halen.
In het volgende voorbeeld haalt de Receive-Job cmdlet de resultaten van de taak op met behulp van het taakobject in de $job variabele.
Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
668 7 2672 6168 104 32.26 488 csrss
...
U kunt de resultaten van een taak opslaan in een variabele. Met de volgende opdracht worden de resultaten van de taak in de $job variabele opgeslagen in de $results variabele.
$results = Receive-Job -Job $job
Resultaten van gedeeltelijke taken ophalen en behouden
De Receive-Job cmdlet haalt de resultaten van een achtergrondtaak op. Als de taak is voltooid, Receive-Job worden alle taakresultaten opgehaald. Als de taak nog steeds wordt uitgevoerd, Receive-Job worden de resultaten opgehaald die tot nu toe zijn gegenereerd. U kunt opdrachten opnieuw uitvoeren Receive-Job om de resterende resultaten op te halen.
Receive-Job Verwijdert standaard de resultaten uit de cache waarin taakresultaten worden opgeslagen. Wanneer u opnieuw uitvoert Receive-Job , krijgt u alleen de nieuwe resultaten die na de eerste uitvoering zijn aangekomen.
De volgende opdrachten geven de resultaten weer van Receive-Job opdrachten die worden uitgevoerd voordat de taak is voltooid.
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Gebruik de parameter Keep om te voorkomen dat Receive-Job de geretourneerde taakresultaten worden verwijderd. De volgende opdrachten tonen het effect van het gebruik van de parameter Keep voor een taak die nog niet is voltooid.
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Wachten op de resultaten
Als u een opdracht uitvoert die lang duurt, kunt u de eigenschappen van het taakobject gebruiken om te bepalen wanneer de taak is voltooid. Met de volgende opdracht wordt het Get-Job object gebruikt om alle achtergrondtaken in de huidige sessie op te halen.
Get-Job
De resultaten worden weergegeven in een tabel. De status van de taak wordt weergegeven in de kolom Status .
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
2 Job2 BackgroundJob Running True localhost Get-EventLog -Log ...
3 Job3 BackgroundJob Complete True localhost dir -Path C:\* -Re...
In dit geval toont de eigenschap Staat aan dat Taak 2 nog steeds wordt uitgevoerd. Als u de Receive-Job cmdlet zou gebruiken om de taakresultaten nu op te halen, zijn de resultaten onvolledig. U kunt de Receive-Job cmdlet herhaaldelijk gebruiken om alle resultaten op te halen. Gebruik de eigenschap State om te bepalen wanneer de taak is voltooid.
U kunt ook de parameter Wait van de Receive-Job cmdlet gebruiken. Wanneer u deze parameter gebruikt, retourneert de cmdlet de opdrachtprompt pas als de taak is voltooid en alle resultaten beschikbaar zijn.
U kunt de Wait-Job cmdlet ook gebruiken om te wachten op een of alle resultaten van de taak. Wait-Job hiermee kunt u wachten op een of meer specifieke taken of op alle taken.
De volgende opdracht gebruikt de Wait-Job cmdlet om te wachten op een taak met id 10.
Wait-Job -ID 10
Als gevolg hiervan wordt de PowerShell-prompt onderdrukt totdat de taak is voltooid.
U kunt ook wachten op een vooraf bepaalde periode. Met deze opdracht wordt de time-outparameter gebruikt om de wachttijd te beperken tot 120 seconden. Wanneer de tijd verloopt, wordt de opdrachtprompt geretourneerd, maar blijft de taak op de achtergrond worden uitgevoerd.
Wait-Job -ID 10 -Timeout 120
Een taak stoppen
Gebruik de Stop-Job cmdlet om een achtergrondtaak te stoppen. Met de volgende opdracht wordt een taak gestart om elke vermelding in het gebeurtenislogboek van het systeem op te halen. Het taakobject wordt opgeslagen in de $job variabele.
$job = Start-Job -ScriptBlock {Get-EventLog -Log System}
Met de volgende opdracht wordt de taak gestopt. Er wordt een pijplijnoperator (|) gebruikt om de taak in de $job variabele naar Stop-Job.
$job | Stop-Job
Een taak verwijderen
Als u een achtergrondtaak wilt verwijderen, gebruikt u de Remove-Job cmdlet. Met de volgende opdracht wordt de taak in de $job variabele verwijderd.
Remove-Job -Job $job
Een mislukte taak onderzoeken
Taken kunnen om verschillende redenen mislukken. het taakobject bevat een redeneigenschap die informatie bevat over de oorzaak van de fout.
In het volgende voorbeeld wordt een taak gestart zonder de vereiste referenties.
$job = Start-Job -ScriptBlock {New-Item -Path HKLM:\Software\MyCompany}
Get-Job $job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost New-Item -Path HKLM:...
Inspecteer de eigenschap Reden om de fout te vinden waardoor de taak is mislukt.
$job.ChildJobs[0].JobStateInfo.Reason
In dit geval is de taak mislukt omdat de externe computer expliciete referenties vereist om de opdracht uit te voeren. De eigenschap Reason bevat het volgende bericht:
Verbinding maken met externe server is mislukt met het volgende foutbericht: 'Toegang is geweigerd'.
