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


Get-Job

Lekéri az aktuális munkamenetben futó PowerShell-háttérfeladatokat.

Syntax

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<CommonParameters>]
Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-InstanceId] <Guid[]>
   [<CommonParameters>]
Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Name] <String[]>
   [<CommonParameters>]
Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-State] <JobState>
   [<CommonParameters>]
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 parancsmaggal Start-Job vagy bármely parancsmag AsJob paraméterével megkezdett feladatok lekérésére használhatóGet-Job.

Paraméterek nélkül a Get-Job parancs az aktuális munkamenet összes feladatát lekéri. Az adott feladatok lekéréséhez használhatja Get-Job a paramétereket.

A visszaadott Get-Job 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. A Windows PowerShell háttérfeladataival kapcsolatos további információkért lásd: 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. A feladat feladattípusának megkereséséhez használja a feladat PSJobTypeName tulajdonságát.

Ha engedélyezni Get-Job szeretné egy egyéni feladattípus lekérését, importálja az egyéni feladattípust támogató modult a munkamenetbe a 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 Név paraméter használatával azonosítja a feladatot. A parancs tárolja a változóban $j visszaadott Get-Job 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 változó értékét $ID . A negyedik parancs parancsmaggal Stop-Job állítja le a feladatot. Az InstanceId paraméter használatával azonosítja a feladatot és $ID a 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 parancsot Get-Process tartalmazó feladatokat a rendszeren. A parancs a parancs paraméterével Get-Job korlátozza a lekért feladatokat. A parancs helyettesítő karaktereket (*) használ az olyan feladatok lekéréséhez, amelyek a parancsot a parancs sztringjében Get-Process bárhol tartalmazzák.

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 parancsot Get-Process tartalmazó feladatokat a rendszeren. A parancs egy folyamatkezelővel (|) küld egy PSCustomObject parancsot a NoteProperty paranccsal 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 lekéri az összes olyan feladatot, 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 lehet lekérni Get-Job egy feladatobjektumot, 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 parancsot Get-Process futtat a helyi számítógépen. A parancs a Név paraméterrel Start-Job rendel hozzá egy rövid nevet a feladathoz. A második parancs a feladat lekérésére használja Get-Job . A feladat azonosításához a Név paramétert Get-Job használja. A parancs menti az eredményként kapott feladatobjektumot a $j változóban. A harmadik parancs megjeleníti a feladatobjektum értékét a $j változóban. Az Állapot tulajdonság értéke azt mutatja, hogy a feladat befejeződött. A HasMoreData tulajdonság értéke azt mutatja, hogy vannak olyan eredmények a feladatból, amelyek még nem lettek lekérve. A negyedik parancs a Receive-Job parancsmagot használja a feladat eredményeinek lekéréséhez. A változó feladatobjektumát használja a $j feladat ábrázolására. A folyamatkezelővel feladatobjektumot is küldhet a rendszernek 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 különböző módszerekkel kezdték őket.

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 AsJob paraméterével Invoke-Command 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 helyi számítógépen tárolt feladatok lekérésére használja Get-Job . A Windows PowerShell 3.0-ban bevezetett feladatok PSJobTypeName tulajdonsága azt mutatja, hogy a parancsmaggal Start-Job indított helyi feladat egy háttérfeladat, és a parancsmag használatával Invoke-Command egy távoli munkamenetben indított feladat egy távoli feladat. Az ötödik, hatodik és hetedik parancs a New-PSSession parancsmaggal hoz létre egy PSSessiont, amely az S2 számítógéphez csatlakozik, és Invoke-Command a PSSession és a Munkamenet paraméter használatával indít el egy feladatot a távoli számítógépen. Ezután lekéri a feladatot az Get-Job S2-számítógépen a PSSession használatával. A mintakimenet a parancs eredményeit jeleníti meg Get-Job . 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ával kapcsolatos további információkért lásd : about_Remote_Jobs.

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álható a feladatobjektum, amely Get-Job visszaadja a feladat sikertelenségének kivizsgálását. 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 visszaadott Start-Job feladatobjektum azt mutatja, hogy a feladat meghiúsult. Az Állapot tulajdonság értéke nem sikerült.

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 parancs eredménye Format-List azt mutatja, hogy a feladat Ok tulajdonságának értéke üres.

A harmadik parancs további vizsgálatokat is folytat. Parancsot Get-Job használ a feladat lekéréséhez, 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 a Feladat2 gyermekfeladatot képviselő feladatobjektum lekérésére használja Get-Job . Ez az a feladat, amelyben a parancs ténylegesen futott. A pont metódust használja a JobStateInfo tulajdonság Reason tulajdonságának lekéréséhez. 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ésére vonatkozó követelményekről további információt a about_Remote_Requirements cí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 kérhet le munkafolyamat-feladatot a Szűrő paraméterrel. 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 Munkafolyamat kulcsszóval hozza létre a WFProcess munkafolyamatot. 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 munkafolyamat PSPrivateMetadata paraméterét pedig egy egyéni azonosító megadásához. A harmadik parancs a Szűrő paraméter használatával Get-Job 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 a parancsmag IncludeChildJob és ChildJobState paramétereinek Get-Job használatát mutatja be.

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 az IncludeChildJob paramétert Get-Jobhaszná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ával és annak Reason tulajdonságával deríti fel, hogy miért nem sikerült a Feladat5.

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 olyan sztringet, amely konvertálható DateTime-objektummá , 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 például a munkafolyamat-feladatok és az ütemezett feladatok, amelyek EndTime tulajdonságúak. 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.

Típus:DateTime
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 például a munkafolyamat-feladatok és az ütemezett feladatok, amelyek EndTime tulajdonságúak. 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.

Típus:DateTime
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ChildJobState

Csak a megadott állapotú gyermekfeladatokat kapja meg. A paraméter elfogadható értékei a következők:

  • NotStarted
  • Futó
  • Befejeződött
  • Sikertelen
  • Leállítva
  • Blokkolva
  • Felfüggesztve
  • Leválasztva
  • Felfüggesztés
  • Leállás

Alapértelmezés szerint Get-Job nem kap gyermekfeladatokat. Az IncludeChildJob paraméterrel 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.

Típus:JobState
Elfogadott értékek:NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-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.

Típus:Hashtable
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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 összes feladat eredménye az aktuális munkamenetben érkezett-e. Ha több eredményt tartalmazó feladatokat szeretne lekérni, adjon meg egy értéket.$True Ha olyan feladatokat szeretne lekérni, amelyek nem rendelkeznek több eredménnyel, adjon meg egy értéket.$False

Egy feladat eredményeinek lekéréséhez használja a Receive-Job parancsmagot.

A parancsmag használatakor törli a Receive-Job 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 $FalseHasMoreData tulajdonságának értékét a ) értékre állítja, jelezve, hogy az aktuális munkamenetben nincs több eredmény a feladathoz. A Keep paraméter használatával megakadályozhatja Receive-Job Receive-Job az eredmények törlését és a HasMoreData tulajdonság értékének módosításá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 másik munkamenetben lévő parancsmaggal Receive-Job ismét lekérheti a feladateredményeket, még akkor is, ha a 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.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 Get-Job paraméterek nélkül.

Típus:Int32[]
Position:0
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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, amelyeknél 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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 Get-Joba következőt: .

Típus:Guid[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-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 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.

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-State

Feladat állapotát adja meg. Ez a parancsmag csak a megadott állapotú feladatokat kapja meg. A paraméter elfogadható értékei a következők:

  • NotStarted
  • Futó
  • Befejeződött
  • Sikertelen
  • Leállítva
  • Blokkolva
  • Felfüggesztve
  • Leválasztva
  • Felfüggesztés
  • Leállás

Alapértelmezés szerint Get-Job lekéri az aktuális munkamenet összes feladatát.

A feladatállapotokról további információt a JobState Enumerálás című témakörben talál.

Típus:JobState
Elfogadott értékek:NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

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 Windows PowerShell a következő aliasokat Get-Jobtartalmazza:

  • 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.

  • BackgroundJob. A helyi feladat a következővel Start-Jobkezdődött: .
  • RemoteJob. A feladat egy PSSession-ben kezdődött a parancsmag AsJob paraméterével Invoke-Command .
  • PSWorkflowJob. A feladat a munkafolyamatok AsJob közös paraméterének használatával kezdődött.