Start-ThreadJob

Referentie

Module:: ThreadJob

Hiermee maakt u achtergrondtaken die vergelijkbaar zijn met de Start-Job cmdlet.

Syntax

Start-ThreadJob
     [-ScriptBlock] <ScriptBlock>
     [-Name <String>]
     [-InitializationScript <ScriptBlock>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [-ThrottleLimit <Int32>]
     [-StreamingHost <PSHost>]
     [<CommonParameters>]

Start-ThreadJob
     [-FilePath] <String>
     [-Name <String>]
     [-InitializationScript <ScriptBlock>]
     [-InputObject <PSObject>]
     [-ArgumentList <Object[]>]
     [-ThrottleLimit <Int32>]
     [-StreamingHost <PSHost>]
     [<CommonParameters>]

Description

Start-ThreadJob maakt achtergrondtaken die vergelijkbaar zijn met de Start-Job cmdlet. Het belangrijkste verschil is dat de taken die worden gemaakt, worden uitgevoerd in afzonderlijke threads binnen het lokale proces. De taken maken standaard gebruik van de huidige werkmap van de aanroeper die de taak heeft gestart.

De cmdlet ondersteunt ook de parameter ThrottleLimit om het aantal taken te beperken dat tegelijk wordt uitgevoerd. Naarmate er meer taken worden gestart, worden ze in de wachtrij geplaatst en wordt gewacht totdat het huidige aantal taken onder de beperkingslimiet komt.

Voorbeelden

Voorbeeld 1: achtergrondtaken Creatie met een threadlimiet van 2

Start-ThreadJob -ScriptBlock { 1..100 | % { sleep 1; "Output $_" } } -ThrottleLimit 2
Start-ThreadJob -ScriptBlock { 1..100 | % { sleep 1; "Output $_" } }
Start-ThreadJob -ScriptBlock { 1..100 | % { sleep 1; "Output $_" } }
Get-Job

Id   Name   PSJobTypeName   State        HasMoreData   Location     Command
--   ----   -------------   -----        -----------   --------     -------
1    Job1   ThreadJob       Running      True          PowerShell   1..100 | % { sleep 1;...
2    Job2   ThreadJob       Running      True          PowerShell   1..100 | % { sleep 1;...
3    Job3   ThreadJob       NotStarted   False         PowerShell   1..100 | % { sleep 1;...

Voorbeeld 2: de prestaties van Start-Job en Start-ThreadJob vergelijken

In dit voorbeeld ziet u het verschil tussen Start-Job en Start-ThreadJob. Met de taken wordt de Start-Sleep cmdlet gedurende 1 seconde uitgevoerd. Omdat de taken parallel worden uitgevoerd, is de totale uitvoeringstijd ongeveer 1 seconde, plus de tijd die nodig is om de taken te maken.

# start five background jobs each running 1 second
Measure-Command {1..5 | % {Start-Job {Start-Sleep 1}} | Wait-Job} | Select-Object TotalSeconds
Measure-Command {1..5 | % {Start-ThreadJob {Start-Sleep 1}} | Wait-Job} | Select-Object TotalSeconds

TotalSeconds
------------
   5.7665849
   1.5735008

Nadat u 1 seconde hebt afgetrokken voor de uitvoeringstijd, ziet u dat het Start-Job ongeveer 4,8 seconden duurt om vijf taken te maken. Start-ThreadJob is 8 keer sneller en duurt ongeveer 0,6 seconden om vijf taken te maken. De resultaten kunnen variëren in uw omgeving, maar de relatieve verbetering moet hetzelfde zijn.

Voorbeeld 3: taken Creatie met behulp van InputObject

In dit voorbeeld gebruikt het scriptblok de $input variabele om invoer te ontvangen van de parameter InputObject . Dit kan ook worden gedaan door objecten door te sluisen naar Start-ThreadJob.

$j = Start-ThreadJob -InputObject (Get-Process pwsh) -ScriptBlock { $input | Out-String }
$j | Wait-Job | Receive-Job

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     94   145.80     159.02      18.31   18276   1 pwsh
    101   163.30     222.05      29.00   35928   1 pwsh

$j = Get-Process pwsh | Start-ThreadJob -ScriptBlock { $input | Out-String }
$j | Wait-Job | Receive-Job

NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
     94   145.80     159.02      18.31   18276   1 pwsh
    101   163.30     222.05      29.00   35928   1 pwsh

Voorbeeld 4: uitvoer van taak Stream naar bovenliggende host

Met behulp van de parameter StreamingHost kunt u een taak laten weten dat alle hostuitvoer naar een specifieke host wordt doorsturen. Zonder deze parameter gaat de uitvoer naar de taakgegevensstroomverzameling en wordt deze niet weergegeven in een hostconsole totdat u de uitvoer van de taak hebt ontvangen.

In dit voorbeeld wordt de huidige host doorgegeven aan Start-ThreadJob met behulp van de $Host automatische variabele.

PS> Start-ThreadJob -ScriptBlock { Read-Host 'Say hello'; Write-Warning 'Warning output' } -StreamingHost $Host

Id   Name   PSJobTypeName   State         HasMoreData     Location      Command
--   ----   -------------   -----         -----------     --------      -------
7    Job7   ThreadJob       NotStarted    False           PowerShell    Read-Host 'Say hello'; ...

PS> Say hello: Hello
WARNING: Warning output
PS> Receive-Job -Id 7
Hello
WARNING: Warning output
PS>

U ziet dat de prompt van Read-Host wordt weergegeven en u invoer kunt typen. Vervolgens wordt het bericht van Write-Warning weergegeven. De Receive-Job cmdlet retourneert alle uitvoer van de taak.

Parameters

-ArgumentList

Hiermee geeft u een matrix van argumenten, of parameterwaarden, voor het script dat is opgegeven door de FilePath - of ScriptBlock-parameters .

ArgumentList moet de laatste parameter op de opdrachtregel zijn. Alle waarden die de parameternaam volgen, worden geïnterpreteerde waarden in de argumentenlijst.

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

-FilePath

Hiermee geeft u een scriptbestand dat moet worden uitgevoerd als een achtergrondtaak. Voer het pad en de bestandsnaam van het script in. Het script moet zich op de lokale computer bevinden of in een map waartoe de lokale computer toegang heeft.

Wanneer u deze parameter gebruikt, converteert PowerShell de inhoud van het opgegeven scriptbestand naar een scriptblok en wordt het scriptblok als achtergrondtaak uitgevoerd.

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

-InitializationScript

Hiermee geeft u opdrachten op die worden uitgevoerd voordat de taak wordt gestart. Plaats de opdrachten tussen accolades ({}) om een scriptblok te maken.

Gebruik deze parameter om de sessie voor te bereiden waarin de taak wordt uitgevoerd. U kunt het bijvoorbeeld gebruiken om functies en modules toe te voegen aan de sessie.

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

-InputObject

Hiermee geeft u de objecten op die worden gebruikt als invoer voor het scriptblok. Het maakt ook pijplijninvoer mogelijk. Gebruik de $input automatische variabele in het scriptblok om toegang te krijgen tot de invoerobjecten.

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

-Name

Hiermee geeft u een beschrijvende naam voor de nieuwe taak. U kunt de naam gebruiken om de taak te identificeren met andere taak-cmdlets, zoals de Stop-Job cmdlet.

De standaard beschrijvende naam is 'Job#', waarbij '#' een rangnummer is dat voor elke taak wordt verhoogd.

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

-ScriptBlock

Hiermee geeft u de opdrachten die moeten worden uitgevoerd in de achtergrondtaak. Plaats de opdrachten tussen accolades ({}) om een scriptblok te maken. Gebruik de $Input automatische variabele om toegang te krijgen tot de waarde van de parameter InputObject . Deze parameter is vereist.

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

-StreamingHost

Deze parameter biedt een veilige manier om uitvoer rechtstreeks naar het doorgegeven PSHost-object te laten Write-Host gaan. Zonder dit Write-Host wordt de uitvoer verzonden naar de gegevensstroomverzameling van de taakgegevens en wordt deze pas weergegeven in een hostconsole nadat de taken zijn uitgevoerd.

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

-ThrottleLimit

Deze parameter beperkt het aantal taken dat tegelijk wordt uitgevoerd. Wanneer taken worden gestart, worden ze in de wachtrij geplaatst en wordt gewacht totdat er een thread beschikbaar is in de threadpool om de taak uit te voeren. De standaardlimiet is 5 threads.

De grootte van de threadgroep is globaal voor de PowerShell-sessie. Als u een ThrottleLimit in één aanroep opgeeft, wordt de limiet ingesteld voor volgende aanroepen in dezelfde sessie.

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

Invoerwaarden

PSObject

Uitvoerwaarden

ThreadJob.ThreadJob

Delen via

Start-ThreadJob

Syntax

Description

Voorbeelden

Voorbeeld 1: achtergrondtaken Creatie met een threadlimiet van 2

Voorbeeld 2: de prestaties van Start-Job en Start-ThreadJob vergelijken

Voorbeeld 3: taken Creatie met behulp van InputObject

Voorbeeld 4: uitvoer van taak Stream naar bovenliggende host

Parameters

-ArgumentList

-FilePath

-InitializationScript

-InputObject

-Name

-ScriptBlock

-StreamingHost

-ThrottleLimit

Invoerwaarden

Uitvoerwaarden

Aanvullende resources

Delen via

Start-ThreadJob

Syntax

Description

Voorbeelden

Voorbeeld 1: achtergrondtaken Creatie met een threadlimiet van 2

Voorbeeld 2: de prestaties van Start-Job en Start-ThreadJob vergelijken

Voorbeeld 3: taken Creatie met behulp van InputObject

Voorbeeld 4: uitvoer van taak Stream naar bovenliggende host

Parameters

-ArgumentList

-FilePath

-InitializationScript

-InputObject

-Name

-ScriptBlock

-StreamingHost

-ThrottleLimit

Invoerwaarden

Uitvoerwaarden

Verwante koppelingen

Aanvullende resources