Get-Job

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>]
   [-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
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<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 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 $j változóban tárolja az Get-Job 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-Jobcommand 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-JobName 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-JobName 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 Invoke-Command parancsmag AsJob 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 Munkafolyamat 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-JobSzűrő 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-JobIncludeChildJob 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

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

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.

• BackgroundJob. A helyi feladat a Start-Jobhasználatával kezdődött.
• RemoteJob. A feladat egy PSSession indult el a Invoke-Command parancsmag AsJob paraméterével.
• PSWorkflowJob. A feladat az AsJob munkafolyamatok gyakori paraméterének használatával kezdődött.

Kapcsolódó hivatkozások

• Invoke-Command
• Receive-Job
• Remove-Job
• Start-Job
• Stop-Job
• Wait-Job
• about_Jobs
• about_Job_Details
• about_Remote_Jobs