Megosztás a következőn keresztül:

Start-Job

Modul:
Microsoft.PowerShell.Core Module

Elindít egy PowerShell-háttérfeladatot.

Syntax

ComputerName (Alapértelmezett) 

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

DefinitionName 

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

FilePathComputerName 

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

LiteralFilePathComputerName 

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

Description

A Start-Job parancsmag elindít egy PowerShell-háttérfeladatot a helyi számítógépen.

A PowerShell háttérfeladatai az aktuális munkamenet használata nélkül futtatnak parancsokat. Háttérfeladat indításakor a feladatobjektum azonnal visszatér, még akkor is, ha a feladat hosszabb időt vesz igénybe. A munkamenetben megszakítás nélkül folytathatja a munkát, amíg a feladat fut.

A feladatobjektum hasznos információkat tartalmaz a feladatról, de nem tartalmazza a feladat eredményeit. Amikor a feladat befejeződött, a Receive-Job parancsmaggal kérje le a feladat eredményeit. További információért a háttérfeladatokról lásd a about_Jobsrészt.

Ha távoli számítógépen szeretne háttérfeladatot futtatni, használja a AsJob paramétert, amely számos parancsmagon elérhető, vagy a Invoke-Command parancsmaggal futtasson egy Start-Job parancsot a távoli számítógépen. További információkért lásd: about_Remote_Jobs.

A PowerShell 3.0-tól kezdve Start-Job egyéni feladattípusok, például ütemezett feladatok példányait indíthatja el. A Start-Job egyéni típusú feladatok indításához való használatával kapcsolatos információkért tekintse meg a feladattípus-funkció súgódokumentumait.

A PowerShell 6.0-tól kezdve az ampersand (&) háttér operátorral kezdheti el a feladatokat. A háttér operátor működése hasonló a Start-Job. A feladatok indításának mindkét metódusa létrehoz egy PSRemotingJob feladatobjektumot. További információ az ampersand (&) használatáról: about_Operators.

A PowerShell 7 bemutatta a WorkingDirectory paramétert, amely meghatározza a háttérfeladat kezdeti munkakönyvtárát. Ha a paraméter nincs megadva, Start-Job alapértelmezés szerint a feladatot kezdeményező hívó aktuális munkakönyvtára lesz.

Megjegyzés:

A folyamaton kívüli háttérfeladatok létrehozása a Start-Job használatával nem támogatott abban az esetben, ha a PowerShell más alkalmazásokban, például a PowerShell Azure Functionökben van üzemeltetve.

Ez azért van így, mert Start-Job attól függ, hogy a pwsh futtatható fájl elérhető-e a $PSHOME alatt egy folyamaton kívüli háttérfeladat elindításához, de amikor egy alkalmazás a PowerShellt fogadja be, az közvetlenül a PowerShell NuGet SDK-csomagokat használja, és nem tartalmazza pwsh-at.

Ebben a forgatókönyvben a helyettesítő a Start-ThreadJob a ThreadJobmodulból.

Példák

1. példa: Háttérfeladat indítása

Ez a példa elindít egy háttérfeladatot, amely a helyi számítógépen fut.

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 a ScriptBlock paraméterrel futtatja a Get-Process háttérfeladatként. A Name paraméter a PowerShell-folyamatok megkeresését határozza meg, pwsh. A feladat adatai megjelennek, és a PowerShell visszatér a parancssori üzenethez, miközben a feladat a háttérben fut.

A feladat kimenetének megtekintéséhez használja a Receive-Job parancsmagot. Például: Receive-Job -Id 1.

2. példa: Háttérfeladat indítása a háttér operátorral

Ez a példa az ampersand (&) háttér operátorral indít el egy háttérfeladatot a helyi számítógépen. A feladat ugyanazt az eredményt kapja, mint Start-Job az 1. példában.

Get-Process -Name pwsh &

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

Get-Process a Name paramétert használja a PowerShell-folyamatok megadásához, pwsh. Az ampersand (&) háttérfeladatként futtatja a parancsot. A feladat adatai megjelennek, és a PowerShell visszatér a parancssori üzenethez, miközben a feladat a háttérben fut.

A feladat kimenetének megtekintéséhez használja a Receive-Job parancsmagot. Például: Receive-Job -Id 5.

3. példa: Feladat indítása Invoke-Command

Ez a példa több számítógépen futtat egy feladatot. A feladat egy változóban van tárolva, és a PowerShell parancssorában található változónév használatával hajtja végre.

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

A Invoke-Command használó feladat létrehozása és tárolása a $jobWRM változóban történik. Invoke-Command a ComputerName paraméter használatával adja meg azokat a számítógépeket, ahol a feladat fut. Get-Content lekéri a kiszolgálóneveket a C:\Servers.txt fájlból.

A ScriptBlock paraméter egy parancsot ad meg, amely Get-Service lekéri a WinRM szolgáltatást. A JobName paraméter a feladat rövid nevét adja meg, WinRM. A ThrottleLimit paraméter az egyidejű parancsok számát 16-ra korlátozza. Az AsJob paraméter elindít egy háttérfeladatot, amely futtatja a parancsot a kiszolgálókon.

4. példa: Feladatadatok lekérése

Ez a példa információkat kap egy feladatról, és megjeleníti a helyi számítógépen futtatott befejezett feladat eredményeit.

$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 a ScriptBlock paraméter segítségével egy olyan parancsot futtat, amely meghatározza Get-WinEvent, hogy lekérje a Rendszer naplót. A Hitelesítő adatok paraméter egy tartományi felhasználói fiókot határoz meg, amely jogosult a feladat futtatására a számítógépen. A feladatobjektum a $j változóban van tárolva.

A $j változóban levő objektum le lesz küldve a csővezetéken keresztül a Select-Object-hez. A tulajdonság paraméter egy csillagot (*) ad meg a feladatobjektum összes tulajdonságának megjelenítéséhez.

5. példa: Szkript futtatása háttérfeladatként

Ebben a példában a helyi számítógépen futó szkript háttérfeladatként fut.

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

Start-Job a FilePath paraméterrel adja meg a helyi számítógépen tárolt szkriptfájlt.

6. példa: Folyamat lekérése háttérfeladat használatával

Ez a példa egy háttérfeladatot használ egy megadott folyamat név szerinti lekéréséhez.

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

Start-Job a Név paramétert használja egy barátságos feladatnév megadásához, PShellJob. A ScriptBlock paraméter Get-Process a powershellnevű folyamatok lekéréséhez.

7. példa: Adatok gyűjtése és mentése háttérfeladat használatával

Ez a példa elindít egy feladatot, amely nagy mennyiségű leképezési adatot gyűjt össze, majd menti egy .tif fájlba.

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

Start-Job a(z) nevű paramétert használja egy barátságos feladatnév megadásához, GetMappingFiles. Az InitializationScript paraméter egy szkriptblokkot futtat, amely importálja a MapFunctions modult. A ScriptBlock paraméter Get-Map fut, és Set-Content menti az adatokat a útvonal paraméter által megadott helyre.

8. példa: Bemenet átadása háttérfeladatnak

Ez a példa a $input automatikus változót használja egy bemeneti objektum feldolgozásához. A feladat kimenetének megtekintése Receive-Job használatával.

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

Server01
Server02
Server03
Server04

Start-Job a ScriptBlock paraméterrel futtatja a Get-Content az $input automatikus változóval. A $input változó az InputObject paraméterből szerzi be az objektumokat. Receive-Job a Name paraméter használatával adja meg a feladatot, és kiadja az eredményeket. A Keep paraméter menti a feladat kimenetét, hogy újra megtekinthető legyen a PowerShell-munkamenet során.

9. példa: A háttérmunka munkakönyvtárának beállítása

A WorkingDirectory lehetővé teszi egy másik könyvtár megadását egy feladathoz, amelyből szkripteket futtathat vagy fájlokat nyithat meg. Ebben a példában a háttérfeladat egy olyan munkakönyvtárat határoz meg, amely eltér az aktuális könyvtár helyétől.

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

Path
----
C:\Test\Scripts

A példa jelenlegi munkakönyvtára C:\Test. Start-Job a WorkingDirectory paraméter használatával adja meg a feladat munkakönyvtárát. A ScriptBlock paraméter $PWD használatával jeleníti meg a feladat munkakönyvtárát. Receive-Job megjeleníti a háttérfeladat kimenetét. AutoRemoveJob törli a feladatot, és Várakozás felfüggeszti a parancssort, amíg az összes eredmény meg nem érkezik.

10. példa: Tömb megadása az Argumentumlista paraméter használatával

Ez a példa a Argumentumlista paramétert használja az argumentumok tömbjének megadásához. A tömb a folyamatnevek vesszővel tagolt listája.

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

A Start-Job parancsmag a parancs futtatásához a ScriptBlock paramétert használja. Get-Process a Név paramétert használja az automatikus változó $argsmegadásához. A ArgumentList paraméter átadja a folyamatnevek tömbjét $args-nek. A powershell, pwsh és jegyzettömb folyamatnevek a helyi számítógépen futó folyamatok.

A feladat kimenetének megtekintéséhez használja a Receive-Job parancsmagot. Például: Receive-Job -Id 1.

11. példa: Feladat futtatása Windows PowerShell 5.1-ben

Ez a példa a PSVersion paramétert használja az 5.1 értékkel a feladat Windows PowerShell 5.1-munkamenetben való futtatásához.

$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

Paraméterek

-ArgumentList

A FilePath paraméter vagy a ScriptBlock paraméterrel megadott parancs argumentumainak vagy paraméterértékeinek tömbje.

Az argumentumokat egydimenziós tömbargumentumként Argumentumlista kell átadni. Például egy vesszővel tagolt lista. Az ArgumentListviselkedésével kapcsolatos további információkért lásd: about_Splatting.

Paramétertulajdonságok

Típus:

Object[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Argumentumok

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Authentication

Megadja a felhasználói hitelesítő adatok hitelesítésére használt mechanizmust.

A paraméter elfogadható értékei a következők:

  • Alapértelmezett
  • Alapszintű
  • Credssp
  • Összefoglaló
  • Kerberos
  • Tárgyal
  • Tárgyalás Beágyazott Hitelesítő Adattal

Az alapértelmezett érték az Alapértelmezett.

A CredSSP-hitelesítés csak a Windows Vista, a Windows Server 2008 és a Windows operációs rendszer újabb verzióiban érhető el.

A paraméter értékeivel kapcsolatos további információkért lásd: AuthenticationMechanism.

Figyelmeztetés

A hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználó hitelesítő adatai átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.

Paramétertulajdonságok

Típus:AuthenticationMechanism
Alapértelmezett érték:Default
Elfogadott értékek:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Ha a Hitelesítő adatok paraméter nincs megadva, a parancs az aktuális felhasználó hitelesítő adatait használja.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:Current user
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DefinitionName

Megadja annak a feladatnak a definíciónevét, amelyet ez a parancsmag indít el. Ezzel a paraméterrel elindíthatja a definíciónevű egyéni feladattípusokat, például az ütemezett feladatokat.

Ha Start-Job használ egy ütemezett feladat egy példányának elindításához, a feladat azonnal elindul, függetlenül a feladat eseményindítóitól vagy a feladat beállításaitól. Az eredményül kapott feladatpéldány egy ütemezett feladat, de nincs mentve a lemezre, mint az aktivált ütemezett feladatoknál. Az Start-Job paraméterével nem adhat meg értékeket az ütemezett feladatban futó szkriptek paramétereihez.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

DefinitionName
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DefinitionPath

Megadja a parancsmag által elinduló feladat definíciójának elérési útját. Adja meg a definíció elérési útját. A DefinitionPath és a DefinitionName paraméterek értékeinek összefűzése adja a feladatdefiníció teljesen minősített elérési útját. Ezzel a paraméterrel olyan egyéni feladattípusokat indíthat el, amelyek definíciós útvonalsal rendelkeznek, például ütemezett feladatokat.

Ütemezett feladatok esetén a DefinitionPath paraméter értéke $HOME\AppData\Local\Windows\PowerShell\ScheduledJob.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

DefinitionName
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FilePath

Meghatároz egy helyi szkriptet, amelyet a Start-Job háttérfeladatként futtat. Adja meg a szkript elérési útját és fájlnevét, vagy a csővezeték használatával küldjön egy szkript elérési útját Start-Job. A szkriptnek a helyi számítógépen vagy egy olyan mappában kell lennie, amelyhez a helyi számítógép hozzáférhet.

Ha ezt a paramétert használja, a PowerShell a megadott szkriptfájl tartalmát szkriptblokkmá alakítja, és háttérfeladatként futtatja a szkriptblokkot.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

FilePathComputerName
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InitializationScript

A feladat indítása előtt futtatott parancsokat adja meg. Szkriptblokk létrehozásához csatolja a parancsokat kapcsos zárójelekbe ({}).

Ezzel a paraméterel előkészíti a munkamenetet, amelyben a feladat fut. Segítségével például függvényeket, beépülő modulokat és modulokat adhat hozzá a munkamenethez.

Paramétertulajdonságok

Típus:ScriptBlock
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InputObject

Megadja a parancs bemenetét. Adjon meg egy változót, amely tartalmazza az objektumokat, vagy írjon be egy parancsot vagy kifejezést, amely létrehozza az objektumokat.

A ScriptBlock paraméter értékében használja a $input automatikus változót a bemeneti objektumok megjelenítéséhez.

Paramétertulajdonságok

Típus:PSObject
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-LiteralPath

Egy helyi szkriptet ad meg, amelyet ez a parancsmag háttérfeladatként futtat. Adja meg egy szkript elérési útját a helyi számítógépen.

Start-Job a LiteralPath paraméter értékét használja pontosan a beíráskor. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath, LP

Paraméterkészletek

LiteralFilePathComputerName
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

Adjon meg egy barátságos nevet az új feladatnak. A névvel azonosíthatja a feladatot más feladatparancsmagok, például a Stop-Job parancsmag számára.

Az alapértelmezett barátságos név a Job#, ahol a # egy sorszám, amely az egyes munkákhoz növekszik.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-PSVersion

Megadja a Feladat futtatásához használni kívánt PowerShell-verziót. Ha a PSVersion értéke 5.1 A feladat Windows PowerShell 5.1-munkamenetben fut. Bármely más érték esetén a feladat a PowerShell aktuális verziójával fut.

Ez a paraméter a PowerShell 7-ben lett hozzáadva, és csak Windows rendszeren működik.

Paramétertulajdonságok

Típus:Version
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-RunAs32

A PowerShell 7-től kezdve a RunAs32 paraméter nem működik a 64 bites PowerShellen (pwsh). Ha RunAs32 a 64 bites PowerShellben van megadva, Start-Job a kivétel megszüntetésével kapcsolatos hibát jelez. Ha 32 bites PowerShell-folyamatot (pwsh) szeretne elindítani RunAs32, telepítenie kell a 32 bites PowerShellt.

A 32 bites PowerShellben RunAs32 kényszeríti a feladatot egy 32 bites folyamat futtatására, még egy 64 bites operációs rendszeren is.

A Windows 7 és a Windows Server 2008 R2 64 bites verzióiban, amikor a Start-Job parancs tartalmazza a RunAs32 paramétert, nem használhatja a Hitelesítő adatok paramétert egy másik felhasználó hitelesítő adatainak megadásához.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
FilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
LiteralFilePathComputerName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ScriptBlock

Megadja a háttérfeladatban futtatandó parancsokat. Szkriptblokk létrehozásához csatolja a parancsokat kapcsos zárójelekbe ({}). Az $input automatikus változóval érheti el az InputObject paraméter értékét. Ez a paraméter kötelező.

Paramétertulajdonságok

Típus:ScriptBlock
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Parancs

Paraméterkészletek

ComputerName
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Type

A Start-Jobáltal indított feladatok egyéni típusát adja meg. Adjon meg egy egyéni feladattípusnevet, például az ütemezett feladatokHOZ tartozó PSScheduledJob vagy a munkafolyamat-feladatokHOZ tartozó PSWorkflowJob nevet. Ez a paraméter normál háttérfeladatokra nem érvényes.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

DefinitionName
Position:2
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WorkingDirectory

A háttérfeladat kezdeti munkakönyvtárát adja meg. Ha a paraméter nincs megadva, a feladat az alapértelmezett helyről fut. Az alapértelmezett hely annak a hívónak az aktuális munkakönyvtára, amely elindította a feladatot.

Ez a paraméter a PowerShell 7-ben lett bevezetve.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:$HOME on Unix (macOS, Linux) and $HOME\Documents on Windows
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

A Name tulajdonsággal rendelkező objektumokat átirányíthatja ehhez a parancsmaghoz a Név paraméterhez. Egy FileInfo objektumot például a Get-ChildItem-ből.

Kimenetek

System.Management.Automation.PSRemotingJob

Ez a parancsmag egy PSRemotingJob objektumot ad vissza, amely az elindított feladatot jelöli.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Start-Job:

  • Minden platform:
    • sajb

A háttérben való futtatáshoz Start-Job a saját munkamenetében fut az aktuális munkamenetben. Amikor a Invoke-Command parancsmaggal futtat egy Start-Job-parancsot egy távoli számítógépen futó munkamenetben, Start-Job a távoli munkamenet keretében fut.