Get-Job
Lekéri az aktuális munkamenetben futó PowerShell-háttérfeladatokat.
Syntax
SessionIdParameterSet (Alapértelmezett)
Get-Job
[[-Id] <Int32[]>]
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
InstanceIdParameterSet
Get-Job
[-InstanceId] <Guid[]>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
NameParameterSet
Get-Job
[-Name] <String[]>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
StateParameterSet
Get-Job
[-State] <JobState>
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[<CommonParameters>]
CommandParameterSet
Get-Job
[-IncludeChildJob]
[-ChildJobState <JobState>]
[-HasMoreData <Boolean>]
[-Before <DateTime>]
[-After <DateTime>]
[-Newest <Int32>]
[-Command <String[]>]
[<CommonParameters>]
FilterParameterSet
Get-Job
[-Filter] <Hashtable>
[<CommonParameters>]
Description
A Get-Job parancsmag olyan objektumokat kap, amelyek az aktuális munkamenetben elindított háttérfeladatokat jelölik. A Get-Job a Start-Job parancsmaggal vagy bármely parancsmag AsJob paraméterével megkezdett feladatok lekéréséhez használható.
Paraméterek nélkül egy Get-Job parancs lekéri az aktuális munkamenet összes feladatát. A Get-Job paramétereit használhatja adott feladatok lekéréséhez.
A Get-Job visszaadott feladatobjektum hasznos információkat tartalmaz a feladatról, de nem tartalmazza a feladat eredményeit. Az eredmények lekéréséhez használja a Receive-Job parancsmagot.
A Windows PowerShell háttérfeladat egy parancs, amely a háttérben fut anélkül, hogy az aktuális munkamenettel dolgozik. Általában háttérfeladatot használ egy összetett parancs futtatásához, amely hosszú időt vesz igénybe. További információ a Windows PowerShell háttérfeladatairól: about_Jobs.
A Windows PowerShell 3.0-tól kezdve a Get-Job parancsmag egyéni feladattípusokat is kap, például munkafolyamat-feladatokat és ütemezett feladatok példányait. Egy feladat feladattípusának megkereséséhez használja a feladat PSJobTypeName tulajdonságát.
Ha engedélyezni szeretné, hogy Get-Job egyéni feladattípust kapjon, importálja az egyéni feladattípust támogató modult a munkamenetbe egy Get-Job parancs futtatása előtt, akár a Import-Module parancsmag használatával, akár a modul parancsmagjának használatával vagy lekérésével. Egy adott egyéni feladattípussal kapcsolatos információkért tekintse meg az egyéni feladattípus-funkció dokumentációját.
Példák
1. példa: Az összes háttérfeladat indítása az aktuális munkamenetben
Ez a parancs az összes háttérfeladatot elindítja az aktuális munkamenetben. Nem tartalmazza a más munkamenetekben létrehozott feladatokat, még akkor sem, ha a feladatok a helyi számítógépen futnak.
Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Completed True localhost $Env:COMPUTERNAME
2. példa: Feladat leállítása példányazonosító használatával
Ezek a parancsok bemutatják, hogyan szerezheti be egy feladat példányazonosítóját, majd hogyan állíthat le egy feladatot. A feladat nevével ellentétben, amely nem egyedi, a példányazonosító egyedi.
Az első parancs a Get-Job parancsmagot használja a feladat lekéréséhez. A feladat azonosításához a Name paramétert használja. A parancs a Get-Job változóban tárolja az $j visszaadott feladatobjektumot. Ebben a példában csak egy feladat szerepel a megadott névvel. A második parancs lekéri az objektum InstanceId tulajdonságát a $j változóban, és a $ID változóban tárolja. A harmadik parancs megjeleníti a $ID változó értékét. A negyedik parancs Stop-Job parancsmaggal állítja le a feladatot.
Az InstanceId paraméter használatával azonosítja a feladatot, és $ID változót a feladat példányazonosítójának megjelenítéséhez.
$j = Get-Job -Name Job1
$ID = $j.InstanceId
$ID
Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55
Stop-Job -InstanceId $ID
3. példa: Adott parancsot tartalmazó feladatok lekérése
Ez a parancs lekéri a Get-Process parancsot tartalmazó feladatokat a rendszeren. A parancs a Get-Job paraméterével korlátozza a lekért feladatokat. A parancs helyettesítő karaktereket (*) használ az Get-Process parancsot tartalmazó feladatok lekéréséhez a parancssztring bármely pontján.
Get-Job -Command "*Get-Process*"
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 BackgroundJob Running True localhost Get-Process
4. példa: Egy adott parancsot tartalmazó feladatok lekérése a folyamat használatával
Az előző példában szereplő parancshoz hasonlóan ez a parancs lekéri a Get-Process parancsot tartalmazó feladatokat a rendszeren. A parancs egy folyamatkezelőt (|) használ egy PSCustomObject és a NoteProperty Commandparancs futtatásához a Get-Job parancsmagnak. Ez az előző parancs megfelelője.
[pscustomobject]@{Command='*Get-Process*'} | Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 BackgroundJob Running True localhost Get-Process
5. példa: Nem elindított feladatok lekérése
Ez a parancs csak azokat a feladatokat kapja meg, amelyek létrejöttek, de még nem lettek elindítva. Ide tartoznak azok a feladatok, amelyek a jövőben fognak futni, és amelyek még nem ütemezettek.
Get-Job -State NotStarted
6. példa: Névvel nem rendelkező feladatok lekérése
Ez a parancs lekéri az összes olyan feladatot, amelynek feladatnevei a feladattal kezdődnek. Mivel job<number> egy feladat alapértelmezett neve, ez a parancs minden olyan feladatot lekér, amely nem rendelkezik explicit módon hozzárendelt névvel.
Get-Job -Name Job*
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Completed True localhost $Env:COMPUTERNAME
7. példa: Feladatobjektum használata a feladat parancsban való megjelenítéséhez
Ez a példa bemutatja, hogyan használhatja a Get-Job egy feladatobjektum lekérésére, majd bemutatja, hogyan használhatja a feladatobjektumot a feladat parancsban való megjelenítésére.
Az első parancs a Start-Job parancsmaggal indít el egy háttérfeladatot, amely egy Get-Process parancsot futtat a helyi számítógépen. A parancs a Start-Job paraméterével rendel hozzá egy rövid nevet a feladathoz. A második parancs Get-Job használja a feladat lekéréséhez. A feladat azonosításához a Get-Job paraméterét használja. A parancs menti az eredményként kapott feladatobjektumot a $j változóba. A harmadik parancs megjeleníti a feladatobjektum értékét a $j változóban. A State tulajdonság értéke azt mutatja, hogy a feladat befejeződött. A HasMoreData tulajdonság értéke azt mutatja, hogy a feladat még nem kapott eredményeket. A negyedik parancs a Receive-Job parancsmagot használja a feladat eredményeinek lekéréséhez. A feladat az $j változóban lévő feladatobjektumot használja a feladat ábrázolásához. A folyamatkezelővel feladatobjektumot is küldhet Receive-Job.
Start-Job -ScriptBlock {Get-Process} -Name MyJob
$j = Get-Job -Name MyJob
$j
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
6 MyJob BackgroundJob Completed True localhost Get-Process
Receive-Job -Job $j
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
124 4 13572 12080 59 1140 audiodg
783 16 11428 13636 100 548 CcmExec
96 4 4252 3764 59 3856 ccmsetup
...
8. példa: Az összes feladat lekérése, beleértve a különböző módszerrel indított feladatokat is
Ez a példa azt mutatja be, hogy a Get-Job parancsmag az aktuális munkamenetben elindított összes feladatot lekérheti, még akkor is, ha azokat különböző módszerekkel kezdték el.
Az első parancs a Start-Job parancsmaggal indít el egy feladatot a helyi számítógépen. A második parancs a parancsmag Invoke-Command paraméterével indít el egy feladatot az S1 számítógépen. Annak ellenére, hogy a feladat parancsai a távoli számítógépen futnak, a feladatobjektum a helyi számítógépen jön létre, így helyi parancsokkal kezelheti a feladatot. A harmadik parancs a Invoke-Command parancsmaggal futtat egy Start-Job parancsot az S2 számítógépen. Ezzel a módszerrel a feladatobjektum a távoli számítógépen jön létre, így távoli parancsokkal kezelheti a feladatot. A negyedik parancs a Get-Job használatával szerzi be a helyi számítógépen tárolt feladatokat. A Windows PowerShell 3.0-ban bevezetett PSJobTypeName tulajdonság azt mutatja, hogy a Start-Job parancsmaggal indított helyi feladat egy háttérfeladat, és a távoli munkamenetben a Invoke-Command parancsmag használatával indított feladat távoli feladat. Az ötödik, hatodik és hetedik parancs a New-PSSession parancsmagot használja az S2 számítógéphez csatlakoztatott PSSession létrehozásához, Invoke-Command használatával indít el egy feladatot a távoli számítógépen a PSSession és a Munkamenet paraméter használatával. Ezután lekéri a feladatot az S2 számítógép Get-Job parancsával a PSSession használatával.
A mintakimenet a Get-Job parancs eredményeit jeleníti meg. Az S2 számítógépen a feladat helyi feladatnak tűnik. A számítógép neve localhost, a feladat típusa pedig egy háttérfeladat.
A háttérfeladatok távoli számítógépeken való futtatásáról további információt a about_Remote_Jobscímű témakörben talál.
Start-Job -ScriptBlock {Get-EventLog -LogName System}
Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog -LogName System} -AsJob
Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Running True localhost Get-EventLog System
2 Job2 RemoteJob Running True S1 Get-EventLog System
$Session = New-PSSession -ComputerName S2
Invoke-Command -Session $Session -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Invoke-Command -Session $Session -ScriptBlock {Get-Job}
Id Name PSJobTypeName State HasMoreData Location Command PSComputerName
-- ---- ------------- ----- ----------- -------- ------- --------------
1 Job1 BackgroundJob Running True localhost Get-EventLog -LogName Sy… S2
9. példa: Sikertelen feladat vizsgálata
Ez a parancs bemutatja, hogyan használhatja az Get-Job visszaadott feladatobjektumot annak vizsgálatára, hogy miért hiúsult meg egy feladat.
Azt is bemutatja, hogyan szerezheti be az egyes feladatok gyermekfeladatait.
Az első parancs a Start-Job parancsmaggal indít el egy feladatot a helyi számítógépen. A Start-Job visszaadott feladatobjektum azt mutatja, hogy a feladat sikertelen volt. A State tulajdonság értéke sikertelen.
A második parancs a Get-Job parancsmagot használja a feladat lekéréséhez. A parancs a pont metódus használatával lekéri az objektum JobStateInfo tulajdonságának értékét. Folyamatkezelő használatával elküldi a JobStateInfo tulajdonságban lévő objektumot a Format-List parancsmagnak, amely egy listában formázja az objektum összes tulajdonságát (*). A Format-List parancs eredménye azt mutatja, hogy a feladat Ok tulajdonságának értéke üres.
A harmadik parancs további vizsgálatokat is folytat. A feladat lekéréséhez egy Get-Job parancsot használ, majd egy folyamatkezelővel elküldi a teljes feladatobjektumot a Format-List parancsmagnak, amely megjeleníti a feladat összes tulajdonságát egy listában. A feladatobjektum összes tulajdonságának megjelenítése azt mutatja, hogy a feladat egy Job2 nevű gyermekfeladatot tartalmaz.
A negyedik parancs Get-Job használatával lekéri a Feladat2 gyermekfeladatot jelképező feladatobjektumot. Ez az a feladat, amelyben a parancs ténylegesen futott. A pont metódus használatával lekéri a JobStateInfo tulajdonság Reason tulajdonságát. Az eredmény azt mutatja, hogy a feladat a hozzáférés megtagadása hiba miatt meghiúsult. Ebben az esetben a felhasználó elfelejtette használni a Futtatás rendszergazdaként lehetőséget a Windows PowerShell indításakor. Mivel a háttérfeladatok a Windows PowerShell újraindító funkcióit használják, a számítógépet újra kell konfigurálni egy feladat futtatásához, még akkor is, ha a feladat a helyi számítógépen fut. A Windows PowerShell újraegyesítési követelményeiről további információt a about_Remote_Requirementscímű témakörben talál. Hibaelhárítási tippekért tekintse meg a about_Remote_Troubleshooting.
PS> Start-Job -ScriptBlock {Get-Process}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost Get-Process
PS> (Get-Job).JobStateInfo | Format-List -Property *
State : Failed
Reason :
PS> Get-Job | Format-List -Property *
HasMoreData : False
StatusMessage :
Location : localhost
Command : Get-Process
JobStateInfo : Failed
Finished : System.Threading.ManualReset
EventInstanceId : fb792295-1318-4f5d-8ac8-8a89c5261507
Id : 1
Name : Job1
ChildJobs : {Job2}
Output : {}
Error : {}
Progress : {}
Verbose : {}
Debug : {}
Warning : {}
StateChanged :
PS> (Get-Job -Name Job2).JobStateInfo.Reason
Connecting to remote server using WSManCreateShellEx api failed. The async callback gave the
following error message: Access is denied.
10. példa: Szűrt eredmények lekérése
Ez a példa bemutatja, hogyan használhatja a Szűrő paramétert munkafolyamat-feladat lekéréséhez. A Windows PowerShell 3.0-ban bevezetett Szűrő paraméter csak egyéni feladattípusokra érvényes, például munkafolyamat-feladatokra és ütemezett feladatokra.
Az első parancs a workflow kulcsszót használja a WFProcess-munkafolyamat létrehozásához. A második parancs a WFProcess munkafolyamat AsJob paraméterével futtatja a munkafolyamatot háttérfeladatként. A munkafolyamat JobName paraméterével adja meg a feladat nevét, a PSPrivateMetadata paraméter pedig egyéni azonosítót ad meg. A harmadik parancs a Get-Job paraméterével kéri le a feladatot a PSPrivateMetadata paraméterben megadott egyéni azonosító alapján.
PS> workflow WFProcess {Get-Process}
PS> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
PS> Get-Job -Filter @{MyCustomId = 92107}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
1 WFProcessJob Completed True localhost WFProcess
11. példa: Információk lekérése gyermekfeladatokról
Ez a példa az IncludeChildJob és ChildJobState paraméterének a Get-Job parancsmagot használja.
Az első parancs lekéri a feladatokat az aktuális munkamenetben. A kimenet tartalmaz egy háttérfeladatot, egy távoli feladatot és egy ütemezett feladat több példányát. Úgy tűnik, hogy a távoli feladat (Job4) meghiúsult.
A második parancs a Get-Job paraméterét használja. A kimenet a gyermekfeladatokkal rendelkező összes feladat gyermekfeladatait adja hozzá. Ebben az esetben a módosított kimenet azt mutatja, hogy csak a 4. feladat 5. gyermekfeladata nem sikerült. A harmadik parancs a ChildJobState paramétert használja sikertelen értékkel. A kimenet az összes szülőfeladatot és csak a sikertelen gyermekfeladatokat tartalmazza. Az ötödik parancs a feladatok JobStateInfo tulajdonságát és annak Reason tulajdonságát használja a feladat5 sikertelenségének felderítéséhez.
PS> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS> Get-Job -IncludeChildJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
3 Job3 Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
5 Job5 Failed False Server01 .\Get-Archive.ps1
6 Job6 Completed True Server02 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS> Get-Job -Name Job4 -ChildJobState Failed
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 BackgroundJob Completed True localhost .\Get-Archive.ps1
4 Job4 RemoteJob Failed True Server01, Server02 .\Get-Archive.ps1
5 Job5 Failed False Server01 .\Get-Archive.ps1
7 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
8 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
9 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
10 UpdateHelpJob PSScheduledJob Completed True localhost Update-Help
PS> (Get-Job -Name Job5).JobStateInfo.Reason
Connecting to remote server Server01 failed with the following error message:
Access is denied.
További információ: about_Remote_Troubleshooting súgótémakör.
Paraméterek
-After
Lekéri a megadott dátum és idő után befejezett feladatokat. Adjon meg egy DateTime objektumot, például a Get-Date parancsmag által visszaadott objektumot, vagy egy sztringet, amely DateTime objektummá alakítható, például Dec 1, 2012 2:00 AM vagy 11/06.
Ez a paraméter csak olyan egyéni feladattípusokon működik, mint a munkafolyamat-feladatok és az ütemezett feladatok, amelyek EndTime tulajdonságot rendelkeznek. Nem működik szabványos háttérfeladatokon, például a Start-Job parancsmag használatával létrehozott feladatokon. A paraméter támogatásáról további információt a feladattípus súgótémakörében talál.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | DateTime |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-Before
Lekéri a megadott dátum és idő előtt befejezett feladatokat. Adjon meg egy DateTime objektumot.
Ez a paraméter csak olyan egyéni feladattípusokon működik, mint a munkafolyamat-feladatok és az ütemezett feladatok, amelyek EndTime tulajdonságot rendelkeznek. Nem működik szabványos háttérfeladatokon, például a Start-Job parancsmag használatával létrehozott feladatokon. A paraméter támogatásáról további információt a feladattípus súgótémakörében talál.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | DateTime |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-ChildJobState
Csak a megadott állapotú gyermekfeladatokat kapja meg. A paraméter elfogadható értékei a következők:
- Még nem kezdődött el
- Futás
- Befejeződött
- Sikertelen
- Megállt
- Letiltott
- Felfüggesztett
- Szétkapcsolva
- Felfüggesztéséről
- Megállás
Alapértelmezés szerint Get-Job nem kap gyermekfeladatokat. Az IncludeChildJob paraméter használatával Get-Job lekéri az összes gyermekfeladatot. Ha a ChildJobState paramétert használja, az IncludeChildJob paraméternek nincs hatása.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | JobState |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-Command
A parancsok tömbjének megadása sztringként. Ez a parancsmag lekéri a megadott parancsokat tartalmazó feladatokat. Az alapértelmezett beállítás az összes feladat. A parancsmintát helyettesítő karakterek használatával is megadhatja.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
CommandParameterSet
| 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 |
-Filter
A feltételek kivonattábláját adja meg. Ez a parancsmag minden feltételnek megfelelő feladatokat kap. Adjon meg egy kivonattáblát, amelyben a kulcsok feladattulajdonságok, az értékek pedig a feladattulajdonságok értékei.
Ez a paraméter csak egyéni feladattípusokon, például munkafolyamat-feladatokon és ütemezett feladatokon működik. Nem működik szabványos háttérfeladatokon, például a Start-Job parancsmag használatával létrehozott feladatokon. A paraméter támogatásáról további információt a feladattípus súgótémakörében talál.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | Hashtable |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
FilterParameterSet
| Position: | 0 |
| Kötelező: | True |
| 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 |
-HasMoreData
Azt jelzi, hogy ez a parancsmag csak a megadott HasMoreData tulajdonságértékekkel rendelkező feladatokat kapja-e meg.
A HasMoreData tulajdonság azt jelzi, hogy az aktuális munkamenetben minden feladateredmény érkezett-e. A több eredménnyel rendelkező feladatok lekéréséhez adjon meg egy $trueértéket. Ha olyan feladatokat szeretne lekérni, amelyek nem rendelkeznek több eredménnyel, adjon meg egy $falseértéket.
Egy feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.
A Receive-Job parancsmag használatakor törli a memóriában lévő, munkamenet-specifikus tárolóból a visszaadott eredményeket. Amikor az aktuális munkamenetben visszaadta a feladat összes eredményét, a feladat HasMoreData tulajdonságának értékét $false) állítja be, jelezve, hogy az aktuális munkamenetben nincs több eredmény a feladathoz. A paraméterével megakadályozhatja, hogy Receive-Job törölje az eredményeket, és módosítsa a Receive-Job tulajdonság értékét.
További információkért írja be a következőt Get-Help Receive-Job:
A HasMoreData tulajdonság az aktuális munkamenetre jellemző. Ha egy egyéni feladattípus eredményeit a munkameneten kívül menti, például az ütemezett feladattípust, amely lemezre menti a feladateredményeket, a Receive-Job másik munkamenetben lévő parancsmaggal ismét lekérheti a feladateredményeket, még akkor is, ha HasMoreData értéke $false. További információt az egyéni feladattípus súgótémakörökben talál.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | Boolean |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-Id
A parancsmag által lekért feladatok azonosítóinak tömbje.
Az azonosító egy egész szám, amely egyedileg azonosítja a feladatot az aktuális munkamenetben. Egyszerűbb megjegyezni és begépelni, mint a példányazonosítót, de csak az aktuális munkamenetben egyedi. Beírhat egy vagy több vesszővel elválasztott azonosítót. Egy feladat azonosítójának megkereséséhez írja be a Get-Job paraméterek nélkül.
Paramétertulajdonságok
| Típus: | Int32[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| Position: | 0 |
| 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 |
-IncludeChildJob
Azt jelzi, hogy ez a parancsmag a szülőfeladatokon kívül gyermekfeladatokat is visszaad.
Ez a paraméter különösen hasznos a munkafolyamat-feladatok vizsgálatához, amelyekhez Get-Job tároló szülőfeladatot és feladathibákat ad vissza, mivel a hiba oka a gyermekfeladat egyik tulajdonságában van mentve.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-InstanceId
A parancsmag által lekért feladatok példányazonosítóinak tömbje. Az alapértelmezett beállítás az összes feladat.
A példányazonosító egy GUID, amely egyedileg azonosítja a feladatot a számítógépen. Egy feladat példányazonosítójának megkereséséhez használja a Get-Job.
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InstanceIdParameterSet
| Position: | 0 |
| Kötelező: | True |
| 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 |
-Name
A parancsmag által lekért feladatok példánybarát nevének tömbje. Adjon meg egy feladatnevet, vagy használjon helyettesítő karaktereket a feladatnévminta megadásához. Alapértelmezés szerint Get-Job az aktuális munkamenet összes feladatát lekéri.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
NameParameterSet
| Position: | 0 |
| Kötelező: | True |
| 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 |
-Newest
Több lekérendő feladatot határoz meg. Ez a parancsmag lekéri a legutóbb befejeződött feladatokat.
A Legújabb paraméter nem rendezi vagy adja vissza a legújabb feladatokat a befejezési sorrendben. A kimenet rendezéséhez használja a Sort-Object parancsmagot.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionIdParameterSet
| 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 |
InstanceIdParameterSet
| 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 |
NameParameterSet
| 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 |
StateParameterSet
| 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 |
CommandParameterSet
| 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 |
-State
Munka állapotát adja meg. Ez a parancsmag csak a megadott állapotú feladatokat kapja meg. A paraméter elfogadható értékei a következők:
- Még nem kezdődött el
- Futás
- Befejeződött
- Sikertelen
- Megállt
- Letiltott
- Felfüggesztett
- Szétkapcsolva
- Felfüggesztéséről
- Megállás
Alapértelmezés szerint Get-Job az aktuális munkamenet összes feladatát lekéri.
További információ a feladatállapotokról a JobState Enumerationcímű szakaszban található.
Paramétertulajdonságok
| Típus: | JobState |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
StateParameterSet
| Position: | 0 |
| Kötelező: | True |
| 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 |
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
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
System.Management.Automation.RemotingJob
Ez a parancsmag olyan objektumokat ad vissza, amelyek a munkamenet feladatait képviselik.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Get-Job:
- Minden platform:
gjb
A feladatok PSJobTypeName tulajdonsága a feladat feladattípusát jelzi. A tulajdonság értékét a feladattípus szerzője határozza meg. Az alábbi lista a gyakori feladattípusokat mutatja be.
-
Háttérfeladat. A helyi feladat a
Start-Jobhasználatával kezdődött. -
RemoteJob. A feladat egy PSSession indult el a parancsmag
Invoke-Commandparaméterével. - PSWorkflowJob. A feladat az AsJob munkafolyamatok gyakori paraméterének használatával kezdődött.
