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>]
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>]
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>]
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 használatával lekérheti a Start-Job parancsmaggal indított feladatokat, vagy bármely parancsmag AsJob paraméterével.
Paraméterek nélkül a Get-Job parancs az aktuális munkamenet összes feladatát lekéri. A Get-Job paramétereit használhatja adott feladatok lekéréséhez.
A Feladat lekérése visszaadott
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 kezdődően 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é Get-Job egyéni feladattípus beszerzését, importálja az egyéni feladattípust támogató modult a munkamenetbe, mielőtt futtatna egy Get-Job parancsot, akár a Import-Module parancsmag használatával, akár a modulban lévő parancsmag 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
PS C:\> Get-Job
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.
2. példa: Feladat leállítása példányazonosító használatával
The first command uses the **Get-Job** cmdlet to get a job. It uses the *Name* parameter to identify the job. The command stores the job object that **Get-Job** returns in the $j variable. In this example, there is only one job with the specified name.
PS C:\> $j = Get-Job -Name Job1
The second command gets the **InstanceId** property of the object in the $j variable and stores it in the $ID variable.
PS C:\> $ID = $j.InstanceID
The third command displays the value of the $ID variable.
PS C:\> $ID
Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55
The fourth command uses Stop-Job cmdlet to stop the job. It uses the *InstanceId* parameter to identify the job and $ID variable to represent the instance ID of the job.
PS C:\> Stop-Job -InstanceId $ID
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.
3. példa: Adott parancsot tartalmazó feladatok lekérése
PS C:\> Get-Job -Command "*get-process*"
Ez a parancs lekéri a Get-Process parancsot tartalmazó feladatokat a rendszeren. A parancs a Get-JobCommand paraméterét használja a lekért feladatok korlátozásához. A parancs helyettesítő karaktereket (*) használ a Get-Process parancsot tartalmazó feladatok lekéréséhez a parancssztring bármely pontján.
4. példa: Egy adott parancsot tartalmazó feladatok lekérése a folyamat használatával
PS C:\> "*get-process*" | Get-Job
Az előző példában szereplő parancshoz hasonlóan ez a parancs is lekéri a Get-Process parancsot tartalmazó feladatokat a rendszeren. A parancs egy folyamatkezelőt (|) használ egy sztring idézőjelekben való elküldéséhez a Get-Job parancsmagnak. Ez az előző parancs megfelelője.
5. példa: Nem elindított feladatok lekérése
PS C:\> Get-Job -State NotStarted
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.
6. példa: Névvel nem rendelkező feladatok lekérése
PS C:\> Get-Job -Name Job*
Ez a parancs lekéri az összes olyan feladatot, amelynek feladatnevei a feladattal kezdődnek. Mivel a feladat<szám,> egy feladat alapértelmezett neve, ez a parancs minden olyan feladatot lekér, amely nem rendelkezik explicit módon hozzárendelt névvel.
7. példa: Feladatobjektum használata a feladat parancsban való megjelenítéséhez
The first command uses the **Start-Job** cmdlet to start a background job that runs a **Get-Process** command on the local computer. The command uses the *Name* parameter of **Start-Job** to assign a friendly name to the job.
PS C:\> Start-Job -ScriptBlock {Get-Process} -Name MyJob
The second command uses Get-Job to get the job. It uses the *Name* parameter of **Get-Job** to identify the job. The command saves the resulting job object in the $j variable.
PS C:\> $j = Get-Job -Name MyJob
The third command displays the value of the job object in the $j variable. The value of the **State** property shows that the job is completed. The value of the **HasMoreData** property shows that there are results available from the job that have not yet been retrieved.
PS C:\> $j
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
6 MyJob BackgroundJob Completed True localhost Get-Process
The fourth command uses the **Receive-Job** cmdlet to get the results of the job. It uses the job object in the $j variable to represent the job. You can also use a pipeline operator to send a job object to **Receive-Job**.
PS C:\> 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
...
Ez a példa bemutatja, hogyan használható Feladat lekérése feladatobjektum lekérésére, majd azt mutatja be, hogyan használhatja a feladatobjektumot a feladat egy parancsban való megjelenítésére.
8. példa: Az összes feladat lekérése, beleértve a különböző módszerrel indított feladatokat is
The first command uses the **Start-Job** cmdlet to start a job on the local computer.
PS C:\> Start-Job -ScriptBlock {Get-EventLog System}
The second command uses the *AsJob* parameter of the **Invoke-Command** cmdlet to start a job on the S1 computer. Even though the commands in the job run on the remote computer, the job object is created on the local computer, so you use local commands to manage the job.
PS C:\> Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog System} -AsJob
The third command uses the **Invoke-Command** cmdlet to run a **Start-Job** command on the S2 computer. By using this method, the job object is created on the remote computer, so you use remote commands to manage the job.
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
The fourth command uses **Get-Job** to get the jobs stored on the local computer. The **PSJobTypeName** property of jobs, introduced in Windows PowerShell 3.0, shows that the local job started by using the **Start-Job** cmdlet is a background job and the job started in a remote session by using the **Invoke-Command** cmdlet is a remote job.
PS C:\> 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
The fifth command uses **Invoke-Command** to run a **Get-Job** command on the S2 computer.The sample output shows the results of the Get-Job command. On the S2 computer, the job appears to be a local job. The computer name is localhost and the job type is a background job.For more information about how to run background jobs on remote computers, see about_Remote_Jobs.
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- ------- -------
4 Job4 BackgroundJob Running True localhost Get-Eventlog System
Ez a példa azt mutatja be, hogy a Get-Job parancsmag az aktuális munkamenetben elindított összes feladatot le tudja szerezni, még akkor is, ha azokat különböző módszerekkel kezdték.
9. példa: Sikertelen feladat vizsgálata
The first command uses the **Start-Job** cmdlet to start a job on the local computer. The job object that **Start-Job** returns shows that the job failed. The value of the **State** property is Failed.
PS C:\> Start-Job -ScriptBlock {Get-Process}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost Get-Process
The second command uses the **Get-Job** cmdlet to get the job. The command uses the dot method to get the value of the **JobStateInfo** property of the object. It uses a pipeline operator to send the object in the **JobStateInfo** property to the Format-List cmdlet, which formats all of the properties of the object (*) in a list.The result of the **Format-List** command shows that the value of the **Reason** property of the job is blank.
PS C:\> (Get-Job).JobStateInfo | Format-List -Property *
State : Failed
Reason :
The third command investigates more. It uses a **Get-Job** command to get the job and then uses a pipeline operator to send the whole job object to the **Format-List** cmdlet, which displays all of the properties of the job in a list.The display of all properties in the job object shows that the job contains a child job named Job2.
PS C:\> 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 :
The fourth command uses **Get-Job** to get the job object that represents the Job2 child job. This is the job in which the command actually ran. It uses the dot method to get the **Reason** property of the **JobStateInfo** property.The result shows that the job failed because of an Access Denied error. In this case, the user forgot to use the Run as administrator option when starting Windows PowerShell.Because background jobs use the remoting features of Windows PowerShell, the computer must be configured for remoting to run a job, even when the job runs on the local computer.For information about requirements for remoting in Windows PowerShell, see about_Remote_Requirements. For troubleshooting tips, see about_Remote_Troubleshooting.
PS C:\> (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.
Ez a parancs bemutatja, hogyan használható az a feladatobjektum, amelyet Feladat lekérése egy feladat sikertelenségének kivizsgálásához. Azt is bemutatja, hogyan szerezheti be az egyes feladatok gyermekfeladatait.
10. példa: Szűrt eredmények lekérése
The first command uses the **Workflow** keyword to create the WFProcess workflow.
PS C:\> Workflow WFProcess {Get-Process}
The second command uses the *AsJob* parameter of the WFProcess workflow to run the workflow as a background job. It uses the *JobName* parameter of the workflow to specify a name for the job, and the *PSPrivateMetadata* parameter of the workflow to specify a custom ID.
PS C:\> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
The third command uses the *Filter* parameter of **Get-Job** to get the job by custom ID that was specified in the *PSPrivateMetadata* parameter.
PS C:\> Get-Job -Filter @{MyCustomId = 92107}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
1 WFProcessJob Completed True localhost WFProcess
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.
11. példa: Információk lekérése gyermekfeladatokról
The first command gets the jobs in the current session. The output includes a background job, a remote job and several instances of a scheduled job. The remote job, Job4, appears to have failed.
PS C:\> 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
The second command uses the *IncludeChildJob* parameter of **Get-Job**. The output adds the child jobs of all jobs that have child jobs.In this case, the revised output shows that only the Job5 child job of Job4 failed.
PS C:\> 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
The third command uses the *ChildJobState* parameter with a value of Failed.The output includes all parent jobs and only the child jobs that failed.
PS C:\> 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
The fifth command uses the **JobStateInfo** property of jobs and its **Reason** property to discover why Job5 failed.
PS C:\> (Get-Job -Name Job5).JobStateInfo.Reason
Connecting to remote server Server01 failed with the following error message:
Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
Ez a példa az IncludeChildJob és ChildJobStateGet-Job parancsmag paramétereinek használatát mutatja be.
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 parancsmaggal 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 |
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 |
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 |
-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 parancsmaggal 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 |
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 |
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 |
-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 |
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 |
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 |
-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 parancsmaggal 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 Fogadófeladat 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 értékre állítja, jelezve, hogy az aktuális munkamenetben nincs több eredmény a feladathoz.
A Fogadófeladat megtartása paraméterével megakadályozhatja, hogy Fogadófeladat törölje az eredményeket, és módosítsa a HasMoreData 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 Fogadófeladat parancsmaggal egy másik munkamenetben is 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 |
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 |
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 |
-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 munkafolyamat-feladatok vizsgálatához, amelyekhez Get-Job egy tároló szülőfeladatát és feladathibáit adja vissza, mert 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 |
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 |
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 |
-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 Feladat lekérése.
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 |
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 |
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 |
-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 Feladat lekérése az aktuális munkamenet összes feladatát lekéri.
További információ a feladatállapotokról: JobState Enumeration az MSDN-kódtárban.
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 csövezhet be bemenetet.
Kimenetek
System.Management.Automation.RemotingJob
Ez a parancsmag olyan objektumokat ad vissza, amelyek a munkamenet feladatait képviselik.
Jegyzetek
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 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.