Delen via

Start-Job

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee start u een PowerShell-achtergrondtaak.

Syntaxis

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

Description

De Start-Job cmdlet start een PowerShell-achtergrondtaak op de lokale computer.

Een PowerShell-achtergrondtaak voert een opdracht uit zonder interactie met de huidige sessie. Wanneer u een achtergrondtaak start, wordt een taakobject 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.

Het taakobject bevat nuttige informatie over de taak, maar bevat geen taakresultaten. Wanneer de taak is voltooid, gebruikt u de cmdlet Receive-Job om de resultaten van de taak op te halen. Zie about_Jobsvoor meer informatie over achtergrondtaken.

Als u een achtergrondtaak wilt uitvoeren op een externe computer, gebruikt u de parameter AsJob die beschikbaar is op veel cmdlets of gebruikt u de Invoke-Command-cmdlet om een Start-Job opdracht uit te voeren op de externe computer. Zie about_Remote_Jobsvoor meer informatie.

Vanaf PowerShell 3.0 kunnen Start-Job exemplaren van aangepaste taaktypen starten, zoals geplande taken. Zie de Help-documenten voor de functie jobtype voor informatie over het gebruik van Start-Job om taken te starten met aangepaste typen.

De standaardwerkmap voor taken is vastgelegd. De Windows-standaardwaarde is $HOME\Documents en in Linux of macOS is de standaardwaarde $HOME. De scriptcode die in de achtergrondtaak wordt uitgevoerd, moet de werkmap zo nodig beheren.

Voorbeelden

Voorbeeld 1: Een achtergrondtaak starten

In dit voorbeeld wordt een achtergrondtaak gestart die wordt uitgevoerd op de lokale computer.

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

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

Start-Job gebruikt de parameter ScriptBlock om Get-Process uit te voeren als achtergrondtaak. De parameter Name geeft aan om PowerShell-processen powershellte vinden. De taakgegevens worden weergegeven en PowerShell keert terug naar een prompt terwijl de taak op de achtergrond wordt uitgevoerd.

Gebruik de cmdlet Receive-Job om de uitvoer van de taak weer te geven. Bijvoorbeeld Receive-Job -Id 1.

Voorbeeld 2: Een taak starten met behulp van Invoke-Command

In dit voorbeeld wordt een taak uitgevoerd op meerdere computers. De taak wordt opgeslagen in een variabele en wordt uitgevoerd met behulp van de naam van de variabele op de PowerShell-opdrachtregel.

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

Een taak die gebruikmaakt van Invoke-Command wordt gemaakt en opgeslagen in de $jobWRM variabele. Invoke-Command gebruikt de parameter ComputerName om de computers op te geven waarop de taak wordt uitgevoerd. Get-Content haalt de servernamen op uit het C:\Servers.txt-bestand.

De parameter ScriptBlock geeft een opdracht op die Get-Service de WinRM--service ophaalt. De parameter JobName geeft een beschrijvende naam op voor de taak, WinRM-. De parameter ThrottleLimit beperkt het aantal gelijktijdige opdrachten tot 16. Met de parameter AsJob wordt een achtergrondtaak gestart waarmee de opdracht op de servers wordt uitgevoerd.

Voorbeeld 3: Taakgegevens ophalen

In dit voorbeeld wordt informatie opgehaald over een taak en worden de resultaten weergegeven van een voltooide taak die is uitgevoerd op de lokale computer.

$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 gebruikt de parameter ScriptBlock om een opdracht uit te voeren waarmee Get-WinEvent wordt opgegeven om het System-logboek op te halen. De parameter Credential geeft een domeingebruikersaccount op met toestemming om de taak op de computer uit te voeren. Het taakobject wordt opgeslagen in de $j variabele.

Het object in de $j-variabele wordt naar Select-Objectverzonden. De parameter eigenschap geeft een sterretje (*) op om alle eigenschappen van het taakobject weer te geven.

Voorbeeld 4: Een script uitvoeren als achtergrondtaak

In dit voorbeeld wordt een script op de lokale computer uitgevoerd als achtergrondtaak.

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

Start-Job gebruikt de parameter FilePath om een scriptbestand op te geven dat is opgeslagen op de lokale computer.

Voorbeeld 5: Een proces ophalen met behulp van een achtergrondtaak

In dit voorbeeld wordt een achtergrondtaak gebruikt om een opgegeven proces op naam op te halen.

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

Start-Job gebruikt de parameter Name om een beschrijvende taaknaam op te geven, PShellJob. De parameter ScriptBlock geeft Get-Process aan om processen op te halen met de naam PowerShell-.

Voorbeeld 6: Gegevens verzamelen en opslaan met behulp van een achtergrondtaak

In dit voorbeeld wordt een taak gestart die een grote hoeveelheid kaartgegevens verzamelt en deze vervolgens opslaat in een .tif-bestand.

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

Start-Job gebruikt de parameter Name om een beschrijvende taaknaam op te geven, GetMappingFiles. Met de parameter InitializationScript wordt een scriptblok uitgevoerd waarmee de module MapFunctions wordt geïmporteerd. De parameter ScriptBlock wordt uitgevoerd Get-Map en Set-Content slaat de gegevens op de locatie op die is opgegeven door de parameter pad pad. De parameter RunAs32 voert het proces uit als 32-bits, zelfs op een 64-bits besturingssysteem.

Voorbeeld 7: Invoer doorgeven aan een achtergrondtaak

In dit voorbeeld wordt de $input automatische variabele gebruikt om een invoerobject te verwerken. Gebruik Receive-Job om de uitvoer van de taak weer te geven.

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

Server01
Server02
Server03
Server04

Start-Job gebruikt de parameter ScriptBlock om Get-Content uit te voeren met de automatische variabele $input. Met de variabele $input worden objecten opgehaald uit de parameter InputObject. Receive-Job gebruikt de parameter Name om de taak op te geven en de resultaten uit te voeren. Met de parameter behouden wordt de taakuitvoer opgeslagen, zodat deze opnieuw kan worden weergegeven tijdens de PowerShell-sessie.

Voorbeeld 8: Gebruik de parameter ArgumentList om een matrix op te geven

In dit voorbeeld wordt de parameter ArgumentList gebruikt om een matrix met argumenten op te geven. De matrix is een door komma's gescheiden lijst met procesnamen.

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

De Start-Job-cmdlet gebruikt de parameter ScriptBlock om een opdracht uit te voeren. Get-Process gebruikt de parameter Name om de automatische variabele $argsop te geven. De parameter ArgumentList geeft de matrix met procesnamen door aan $args. De procesnamen powershell, pwsh en kladblok zijn processen die worden uitgevoerd op de lokale computer.

Gebruik de cmdlet Receive-Job om de uitvoer van de taak weer te geven. Bijvoorbeeld Receive-Job -Id 1.

Parameters

-ArgumentList

Hiermee geeft u een matrix met argumenten of parameterwaarden op voor het script dat is opgegeven door de parameter FilePath of een opdracht die is opgegeven met de parameter ScriptBlock.

Argumenten moeten worden doorgegeven aan ArgumentList als matrixargument met één dimensie. Bijvoorbeeld een door komma's gescheiden lijst. Zie about_Splattingvoor meer informatie over het gedrag van ArgumentList.

Type:Object[]
Aliassen:Args
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Authentication

Hiermee geeft u het mechanisme op dat wordt gebruikt om gebruikersreferenties te verifiëren.

De acceptabele waarden voor deze parameter zijn als volgt:

  • Verstek
  • Basisch
  • Credssp
  • Verteren
  • Kerberos
  • Onderhandelen
  • NegotiateWithImplicitCredential

De standaardwaarde is Standaard.

CredSSP-verificatie is alleen beschikbaar in Windows Vista, Windows Server 2008 en latere versies van het Windows-besturingssysteem.

Zie AuthenticationMechanismvoor meer informatie over de waarden van deze parameter.

Voorzichtigheid

CredSSP-verificatie (Credential Security Support Provider), waarbij de referenties van de gebruiker worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

Type:AuthenticationMechanism
Geaccepteerde waarden:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Default
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Als de parameter Credential niet is opgegeven, gebruikt de opdracht de referenties van de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential--object in dat is gegenereerd door de Get-Credential-cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString-.

Notitie

Zie voor meer informatie over SecureString gegevensbeveiliging Hoe veilig is SecureString?.

Type:PSCredential
Position:Named
Default value:Current user
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefinitionName

Hiermee geeft u de definitienaam op van de taak die door deze cmdlet wordt gestart. Gebruik deze parameter om aangepaste taaktypen te starten met een definitienaam, zoals geplande taken.

Wanneer u Start-Job gebruikt om een exemplaar van een geplande taak te starten, wordt de taak onmiddellijk gestart, ongeacht taaktriggers of taakopties. Het resulterende taakexemplaren is een geplande taak, maar wordt niet opgeslagen op schijf, zoals geactiveerde geplande taken. U kunt de parameter ArgumentList van Start-Job niet gebruiken om waarden op te geven voor parameters van scripts die worden uitgevoerd in een geplande taak. Zie about_Scheduled_Jobsvoor meer informatie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefinitionPath

Hiermee geeft u het pad op van de definitie voor de taak die met deze cmdlet wordt gestart. Voer het definitiepad in. De samenvoeging van de waarden van de parameters DefinitionPath en DefinitionName is het volledig gekwalificeerde pad van de taakdefinitie. Gebruik deze parameter om aangepaste taaktypen te starten die een definitiepad hebben, zoals geplande taken.

Voor geplande taken wordt de waarde van de parameter DefinitionPath$HOME\AppData\Local\Windows\PowerShell\ScheduledJob.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FilePath

Hiermee geeft u een lokaal script op dat Start-Job wordt uitgevoerd als achtergrondtaak. Voer het pad en de bestandsnaam van het script in of gebruik de pijplijn om een scriptpad naar Start-Jobte verzenden. Het script moet zich op de lokale computer of in een map bevinden waartoe de lokale computer toegang heeft.

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

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InitializationScript

Hiermee geeft u opdrachten die worden uitgevoerd voordat de taak wordt gestart. Als u een scriptblok wilt maken, plaatst u de opdrachten tussen accolades ({}).

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

Type:ScriptBlock
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u invoer voor de opdracht. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden gegenereerd.

Gebruik in de waarde van de parameter ScriptBlock de automatische variabele $input om de invoerobjecten weer te geven.

Type:PSObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u een lokaal script op dat door deze cmdlet als achtergrondtaak wordt uitgevoerd. Voer het pad in van een script op de lokale computer.

Start-Job gebruikt de waarde van de parameter LiteralPath precies zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String
Aliassen:PSPath
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een beschrijvende naam voor de nieuwe taak. U kunt de naam gebruiken om de taak te identificeren voor 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PSVersion

Hiermee geeft u een versie. Start-Job voert de taak uit met de versie van PowerShell. De acceptabele waarden voor deze parameter zijn: 2.0 en 3.0.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAs32

Geeft aan dat Start-Job de taak in een 32-bits proces uitvoert. RunAs32 dwingt de taak uit te voeren in een 32-bits proces, zelfs op een 64-bits besturingssysteem.

Op 64-bits versies van Windows 7 en Windows Server 2008 R2, wanneer de opdracht Start-Job de RunAs32 parameter bevat, kunt u de parameter Credential niet gebruiken om de referenties van een andere gebruiker op te geven.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScriptBlock

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

Type:ScriptBlock
Aliassen:Command
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Type

Hiermee geeft u het aangepaste type voor taken die zijn gestart door Start-Job. Voer een aangepaste taaktypenaam in, zoals PSScheduledJob voor geplande taken of PSWorkflowJob voor werkstroomtaken. Deze parameter is niet geldig voor standaardachtergrondtaken.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een object doorsluisen met de eigenschap Name naar de parameter Name naar deze cmdlet. U kunt bijvoorbeeld een FileInfo--object uit Get-ChildItemdoorsluisen.

Uitvoerwaarden

System.Management.Automation.PSRemotingJob

Deze cmdlet retourneert een PSRemotingJob object dat de taak vertegenwoordigt die is gestart.

Notities

Windows PowerShell bevat de volgende aliassen voor Start-Job:

  • sajb

Als u op de achtergrond wilt uitvoeren, wordt Start-Job uitgevoerd in een eigen sessie in de huidige sessie. Wanneer u de cmdlet Invoke-Command gebruikt om een Start-Job-opdracht uit te voeren in een sessie op een externe computer, wordt Start-Job uitgevoerd in een sessie in de externe sessie.