Start-Job

Start-Job
    [-ScriptBlock] <ScriptBlock>
    [[-InitializationScript] <ScriptBlock>]
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-WorkingDirectory <String>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Start-Job
    [-DefinitionName] <String>
    [[-DefinitionPath] <String>]
    [[-Type] <String>]
    [-WorkingDirectory <String>]
    [<CommonParameters>]

Start-Job
    [-FilePath] <String>
    [[-InitializationScript] <ScriptBlock>]
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-WorkingDirectory <String>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Start-Job
    [[-InitializationScript] <ScriptBlock>]
    -LiteralPath <String>
    [-Name <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-WorkingDirectory <String>]
    [-RunAs32]
    [-PSVersion <Version>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Cmdleten Start-Job startar ett PowerShell-bakgrundsjobb på den lokala datorn.

Ett PowerShell-bakgrundsjobb kör ett kommando utan att interagera med den aktuella sessionen. När du startar ett bakgrundsjobb returneras ett jobbobjekt omedelbart, även om jobbet tar längre tid att slutföra. Du kan fortsätta att arbeta i sessionen utan avbrott medan jobbet utförs.

Jobbobjektet innehåller användbar information om jobbet, men det innehåller inte jobbresultatet. När jobbet är klart använder du cmdleten Receive-Job för att hämta resultatet av jobbet. Mer information om bakgrundsjobb finns i about_Jobs.

Om du vill köra ett bakgrundsjobb på en fjärrdator använder du parametern AsJob som är tillgänglig på många cmdletar eller använder cmdleten Invoke-Command för att köra ett Start-Job-kommando på fjärrdatorn. Mer information finns i about_Remote_Jobs.

Från och med PowerShell 3.0 kan Start-Job starta instanser av anpassade jobbtyper, till exempel schemalagda jobb. Information om hur du använder Start-Job för att starta jobb med anpassade typer finns i hjälpdokumenten för jobbtypsfunktionen.

Från och med PowerShell 6.0 kan du starta jobb med bakgrundsoperatorn ampersand (&). Funktionen för bakgrundsoperatorn liknar Start-Job. Båda metoderna för att starta ett jobb skapar ett PSRemotingJob jobbobjekt. Mer information om hur du använder et-et (&) finns i about_Operators.

PowerShell 7 introducerade parametern WorkingDirectory som anger ett bakgrundsjobbs inledande arbetskatalog. Om parametern inte har angetts, så kommer Start-Job som standard att inställas till den aktuella arbetskatalogen för den som startade jobbet.

Det här exemplet startar ett bakgrundsjobb som körs på den lokala datorn.

Start-Job -ScriptBlock { Get-Process -Name pwsh }

Id  Name   PSJobTypeName   State     HasMoreData   Location    Command
--  ----   -------------   -----     -----------   --------    -------
1   Job1   BackgroundJob   Running   True          localhost   Get-Process -Name pwsh

Start-Job använder parametern ScriptBlock för att köra Get-Process som ett bakgrundsjobb. Parametern Name anger att hitta PowerShell-processer pwsh. Jobbinformationen visas och PowerShell återgår till en prompt, och jobbet körs i bakgrunden.

Om du vill visa jobbets utdata använder du cmdleten Receive-Job. Till exempel Receive-Job -Id 1.

I det här exemplet används bakgrundsoperatorn ampersand (&) för att starta ett bakgrundsjobb på den lokala datorn. Jobbet får samma resultat som Start-Job i exempel 1.

Get-Process -Name pwsh &

Id    Name   PSJobTypeName   State       HasMoreData     Location      Command
--    ----   -------------   -----       -----------     --------      -------
5     Job5   BackgroundJob   Running     True            localhost     Microsoft.PowerShell.Man...

Get-Process använder parametern Name för att ange PowerShell-processer pwsh. Ampersand (&) kör kommandot som ett bakgrundsjobb. Jobbinformationen visas och PowerShell återgår till en prompt, och jobbet körs i bakgrunden.

Om du vill visa jobbets utdata använder du cmdleten Receive-Job. Till exempel Receive-Job -Id 5.

Det här exemplet kör ett jobb på flera datorer. Jobbet lagras i en variabel och körs med hjälp av variabelnamnet på PowerShell-kommandoraden.

$jobWRM = Invoke-Command -ComputerName (Get-Content -Path C:\Servers.txt) -ScriptBlock {
   Get-Service -Name WinRM } -JobName WinRM -ThrottleLimit 16 -AsJob

Ett jobb som använder Invoke-Command skapas och lagras i variabeln $jobWRM. Invoke-Command använder parametern ComputerName för att ange de datorer där jobbet körs. Get-Content hämtar servernamnen från C:\Servers.txt-filen.

Parametern ScriptBlock anger ett kommando som Get-Service hämtar tjänsten WinRM. Parametern JobName anger ett lättläst namn för jobbet, WinRM. Parametern ThrottleLimit begränsar antalet samtidiga kommandon till 16. Parametern AsJob startar ett bakgrundsjobb som kör kommandot på servrarna.

Det här exemplet hämtar information om ett jobb och visar resultatet av ett slutfört jobb som kördes på den lokala datorn.

$j = Start-Job -ScriptBlock { Get-WinEvent -Log System } -Credential Domain01\User01
$j | Select-Object -Property *

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-WinEvent -Log System
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : 27ce3fd9-40ed-488a-99e5-679cd91b9dd3
Id            : 18
Name          : Job18
ChildJobs     : {Job19}
PSBeginTime   : 8/8/2019 14:41:57
PSEndTime     : 8/8/2019 14:42:07
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Job använder parametern ScriptBlock för att köra ett kommando som anger Get-WinEvent för att hämta loggen System. Parametern Credential anger ett domänanvändarkonto med behörighet att köra jobbet på datorn. Jobbobjektet lagras i variabeln $j.

Objektet i variabeln $j skickas ned i pipelinen till Select-Object. Parametern Egenskap anger en asterisk (*) för att visa alla jobbobjektets egenskaper.

I det här exemplet körs ett skript på den lokala datorn som ett bakgrundsjobb.

Start-Job -FilePath C:\Scripts\Sample.ps1

Start-Job använder parametern FilePath för att ange en skriptfil som lagras på den lokala datorn.

I det här exemplet används ett bakgrundsjobb för att hämta en angiven process efter namn.

Start-Job -Name PShellJob -ScriptBlock { Get-Process -Name powershell }

Start-Job använder parametern Name för att ange ett eget jobbnamn, PShellJob. Parametern ScriptBlock anger Get-Process för att hämta processer med namnet powershell.

Det här exemplet startar ett jobb som samlar in en stor mängd kartdata och sedan sparar dem i en .tif fil.

Start-Job -Name GetMappingFiles -InitializationScript {Import-Module -Name MapFunctions} -ScriptBlock {
   Get-Map -Name * | Set-Content -Path D:\Maps.tif }

Start-Job använder parametern Name för att ange ett eget jobbnamn GetMappingFiles. Parametern InitializationScript kör ett skriptblock som importerar modulen MapFunctions. Parametern ScriptBlock körs Get-Map och Set-Content sparar data på den plats som anges av parametern Path.

I det här exemplet används den $input automatiska variabeln för att bearbeta ett indataobjekt. Använd Receive-Job för att se jobbets resultat.

Start-Job -ScriptBlock { Get-Content -Path $input } -InputObject "C:\Servers.txt"
Receive-Job -Name Job45 -Keep

Server01
Server02
Server03
Server04

Start-Job använder parametern ScriptBlock för att köra Get-Content med den $input automatiska variabeln. Variabeln $input hämtar objekt från parametern InputObject. Receive-Job använder parametern Name för att ange jobbet och returnerar resultatet. Parametern Keep sparar jobbutdata så att det kan visas igen under PowerShell-sessionen.

Med WorkingDirectory- kan du ange en alternativ katalog för ett jobb där du kan köra skript eller öppna filer. I det här exemplet anger bakgrundsjobbet en arbetskatalog som skiljer sig från den aktuella katalogplatsen.

PS C:\Test> Start-Job -WorkingDirectory C:\Test\Scripts { $PWD } | Receive-Job -AutoRemoveJob -Wait

Path
----
C:\Test\Scripts

Det här exemplets aktuella arbetskatalog är C:\Test. Start-Job använder parametern WorkingDirectory för att ange jobbets arbetskatalog. Parametern ScriptBlock använder $PWD för att visa jobbets arbetskatalog. Receive-Job visar bakgrundsjobbets resultat. AutoRemoveJob tar bort jobbet och Wait undertrycker kommandotolken tills alla resultat tas emot.

I det här exemplet används parametern ArgumentList för att ange en matris med argument. Matrisen är en kommaavgränsad lista över processnamn.

Start-Job -ScriptBlock { Get-Process -Name $args } -ArgumentList powershell, pwsh, notepad

Id     Name      PSJobTypeName   State       HasMoreData     Location     Command
--     ----      -------------   -----       -----------     --------     -------
1      Job1      BackgroundJob   Running     True            localhost    Get-Process -Name $args

Cmdleten Start-Job använder parametern ScriptBlock för att köra ett kommando. Get-Process använder parametern Name för att ange den automatiska variabeln $args. Parametern ArgumentList skickar matrisen med processnamn till $args. Processnamnen powershell, pwsh och anteckningar är processer som körs på den lokala datorn.

Om du vill visa jobbets utdata använder du cmdleten Receive-Job. Till exempel Receive-Job -Id 1.

I det här exemplet används parametern PSVersion med värdet 5.1 för att köra jobbet i en Windows PowerShell 5.1-session.

$PSVersionTable.PSVersion

Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
7      0      0      rc.1

$job = Start-Job -ScriptBlock { $PSVersionTable.PSVersion } -PSVersion 5.1
Receive-Job -Job $job

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      14393  3383

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett objekt med egenskapen Name till parametern Name till den här cmdleten. Du kan till exempel skicka ett FileInfo--objekt från Get-ChildItem.

Den här cmdleten returnerar ett PSRemotingJob- objekt som representerar jobbet som det startade.

PowerShell innehåller följande alias för Start-Job:

• Alla plattformar:
  • sajb

För att köras i bakgrunden körs Start-Job i en egen session i den aktuella sessionen. När du använder cmdleten Invoke-Command för att köra ett Start-Job kommando i en session på en fjärrdator körs Start-Job i en session i fjärrsessionen.