Get-Job

Reference

Modul:: Microsoft.PowerShell.Core

Získá úlohy na pozadí PowerShellu, které jsou spuštěny v aktuální relaci.

Syntaxe

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

Rutina Get-Job získá objekty, které představují úlohy na pozadí, které byly spuštěny v aktuální relaci. Pomocí Get-Job můžete získat úlohy, které byly spuštěny pomocí rutiny Start-Job, nebo pomocí parametru AsJob libovolné rutiny.

Bez parametrů získá příkaz Get-Job všechny úlohy v aktuální relaci. K získání konkrétních úloh můžete použít parametry Get-Job.

Objekt úlohy, který Get-Job vrátí, obsahuje užitečné informace o úloze, ale neobsahuje výsledky úlohy. K získání výsledků použijte rutinu Receive-Job.

Úloha prostředí Windows PowerShell na pozadí je příkaz, který běží na pozadí bez interakce s aktuální relací. Pomocí úlohy na pozadí obvykle spustíte složitý příkaz, který trvá dlouhou dobu. Další informace o úlohách na pozadí v prostředí Windows PowerShell naleznete v tématu about_Jobs.

Počínaje Windows PowerShellem 3.0 získá rutina Get-Job také vlastní typy úloh, jako jsou úlohy pracovního postupu a instance naplánovaných úloh. K vyhledání typu úlohy použijte vlastnost PSJobTypeName úlohy.

Pokud chcete povolit Get-Job získat vlastní typ úlohy, naimportujte modul, který podporuje vlastní typ úlohy, před spuštěním příkazu Get-Job buď pomocí rutiny Import-Module, nebo pomocí rutiny nebo získání rutiny v modulu. Informace o konkrétním vlastním typu úlohy najdete v dokumentaci funkce vlastního typu úlohy.

Příklady

Příklad 1: Zahájení všech úloh na pozadí v aktuální relaci

Tento příkaz načte všechny úlohy na pozadí spuštěné v aktuální relaci. Nezahrnuje úlohy vytvořené v jiných relacích, i když se úlohy spouštějí na místním počítači.

Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Příklad 2: Zastavení úlohy pomocí ID instance

Tyto příkazy ukazují, jak získat ID instance úlohy a pak ji použít k zastavení úlohy. Na rozdíl od názvu úlohy, která není jedinečná, je ID instance jedinečné.

První příkaz použije rutinu Get-Job k získání úlohy. K identifikaci úlohy používá parametr Name. Příkaz uloží objekt úlohy, který Get-Job vrátí do proměnné $j. V tomto příkladu existuje pouze jedna úloha se zadaným názvem. Druhý příkaz získá vlastnost InstanceId objektu v proměnné $j a uloží ji do proměnné $ID. Třetí příkaz zobrazí hodnotu proměnné $ID. Čtvrtý příkaz k zastavení úlohy používá rutinu Stop-Job. Pomocí parametru InstanceId identifikuje úlohu a $ID proměnnou představující ID instance úlohy.

$j = Get-Job -Name Job1
$ID = $j.InstanceID
$ID

Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55

Stop-Job -InstanceId $ID

Příklad 3: Získání úloh, které obsahují konkrétní příkaz

Tento příkaz získá úlohy v systému, které obsahují příkaz Get-Process. Příkaz používá parametr CommandGet-Job k omezení načtených úloh. Příkaz používá zástupné znaky (*) k získání úloh, které obsahují příkaz Get-Process kdekoli v příkazovém řetězci.

Get-Job -Command "*Get-Process*"

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Příklad 4: Získání úloh, které obsahují konkrétní příkaz pomocí kanálu

Podobně jako příkaz v předchozím příkladu získá tento příkaz úlohy v systému, které obsahují příkaz Get-Process. Příkaz pomocí operátoru kanálu (|) odešle objekt PSCustomObject s CommandNoteProperty do rutiny Get-Job. Je to ekvivalent předchozího příkazu.

[pscustomobject]@{Command='*Get-Process*'} | Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Příklad 5: Získání úloh, které nebyly spuštěny

Tento příkaz získá pouze úlohy, které byly vytvořeny, ale ještě nebyly spuštěny. To zahrnuje úlohy, které jsou naplánované tak, aby běžely v budoucnu, a ty, které ještě nejsou naplánované.

Get-Job -State NotStarted

Příklad 6: Získání úloh, které nemají přiřazený název

Tento příkaz získá všechny úlohy, které mají názvy úloh, které začínají úlohou. Protože job<number> je výchozím názvem úlohy, tento příkaz získá všechny úlohy, které nemají explicitně přiřazený název.

Get-Job -Name Job*

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Příklad 7: Použití objektu úlohy k reprezentaci úlohy v příkazu

Tento příklad ukazuje, jak pomocí Get-Job získat objekt úlohy a pak ukazuje, jak pomocí objektu úlohy reprezentovat úlohu v příkazu.

První příkaz pomocí rutiny Start-Job spustí úlohu na pozadí, která spustí příkaz Get-Process na místním počítači. Příkaz používá parametr NameStart-Job k přiřazení popisného názvu úlohy. Druhý příkaz používá k získání úlohy Get-Job. K identifikaci úlohy používá parametr NameGet-Job. Příkaz uloží výsledný objekt úlohy do proměnné $j. Třetí příkaz zobrazí hodnotu objektu úlohy v proměnné $j. Hodnota vlastnosti State ukazuje, že úloha je dokončena. Hodnota HasMoreData vlastnost ukazuje, že jsou k dispozici výsledky z úlohy, které ještě nebyly načteny. Čtvrtý příkaz používá rutinu Receive-Job k získání výsledků úlohy. Objekt úlohy v proměnné $j používá k reprezentaci úlohy. Operátor kanálu můžete také použít k odeslání objektu úlohy do 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
...

Příklad 8: Získání všech úloh včetně úloh spuštěných jinou metodou

Tento příklad ukazuje, že rutina Get-Job může získat všechny úlohy, které byly spuštěny v aktuální relaci, i když byly spuštěny pomocí různých metod.

První příkaz používá rutinu Start-Job ke spuštění úlohy v místním počítači. Druhý příkaz použije parametr AsJob rutiny Invoke-Command ke spuštění úlohy na počítači S1. I když příkazy v úloze běží na vzdáleném počítači, objekt úlohy se vytvoří v místním počítači, takže ke správě úlohy použijete místní příkazy. Třetí příkaz používá rutinu Invoke-Command ke spuštění příkazu Start-Job na počítači S2. Pomocí této metody se objekt úlohy vytvoří ve vzdáleném počítači, takže ke správě úlohy použijete vzdálené příkazy. Čtvrtý příkaz používá Get-Job k získání úloh uložených v místním počítači. Vlastnost PSJobTypeName úloh zavedených ve Windows PowerShellu 3.0 ukazuje, že místní úloha spuštěná pomocí rutiny Start-Job je úloha na pozadí a úloha spuštěná ve vzdálené relaci pomocí rutiny Invoke-Command je vzdálená úloha. Pátý, šestý a sedmý příkaz používá rutinu New-PSSession k vytvoření psSession, která je připojena k počítači S2, používá Invoke-Command ke spuštění úlohy na vzdáleném počítači pomocí PSSession a parametru Session. Potom získá úlohu pomocí příkazu Get-Job na počítači S2 pomocí psSession. Ukázkový výstup ukazuje výsledky příkazu Get-Job. Na počítači S2 se zdá, že úloha je místní úlohou. Název počítače je localhost a typ úlohy je úloha na pozadí. Další informace o spouštění úloh na pozadí na vzdálených počítačích naleznete v tématu 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

Příklad 9: Prozkoumání neúspěšné úlohy

Tento příkaz ukazuje, jak pomocí objektu úlohy, který Get-Job vrátit, zjistit, proč úloha selhala. Také ukazuje, jak získat podřízené úlohy každé úlohy.

První příkaz používá rutinu Start-Job ke spuštění úlohy v místním počítači. Objekt úlohy, který Start-Job vrátí, ukazuje, že úloha selhala. Hodnota vlastnosti State je neúspěšná.

Druhý příkaz k získání úlohy použije rutinu Get-Job. Příkaz používá tečku metoda získat hodnotu JobStateInfo vlastnost objektu. Pomocí operátoru kanálu odešle objekt v JobStateInfo vlastnost do rutiny Format-List, která formátuje všechny vlastnosti objektu (*) v seznamu. Výsledek příkazu Format-List ukazuje, že hodnota Reason vlastnosti úlohy je prázdná.

Třetí příkaz prozkoumá více. K získání úlohy použije příkaz Get-Job a pak pomocí operátoru kanálu odešle celý objekt úlohy do rutiny Format-List, která zobrazí všechny vlastnosti úlohy v seznamu. Zobrazení všech vlastností v objektu úlohy ukazuje, že úloha obsahuje podřízenou úlohu s názvem Job2.

Čtvrtý příkaz používá Get-Job k získání objektu úlohy, který představuje podřízenou úlohu Job2. Jedná se o úlohu, ve které se příkaz skutečně spustil. Pomocí tečka metoda získat Reason vlastnost JobStateInfo vlastnost. Výsledek ukazuje, že úloha selhala kvůli chybě odepření přístupu. V tomto případě uživatel zapomněl při spouštění Prostředí Windows PowerShell použít možnost Spustit jako správce. Protože úlohy na pozadí používají funkce vzdálené komunikace prostředí Windows PowerShell, musí být počítač nakonfigurován pro vzdálené komunikace ke spuštění úlohy, i když je úloha spuštěna na místním počítači. Informace o požadavcích pro vzdálené komunikace ve Windows PowerShellu najdete v tématu about_Remote_Requirements. Tipy pro řešení potíží najdete v tématu 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.

Příklad 10: Získání filtrovaných výsledků

Tento příklad ukazuje, jak pomocí parametru Filter získat úlohu pracovního postupu. Parametr Filter zavedený ve Windows PowerShellu 3.0 je platný jenom u vlastních typů úloh, jako jsou úlohy pracovního postupu a naplánované úlohy.

První příkaz používá klíčové slovo Workflow k vytvoření pracovního postupu WFProcess. Druhý příkaz používá AsJob parametr pracovního postupu WFProcess ke spuštění pracovního postupu jako úlohy na pozadí. Pomocí parametru JobName pracovního postupu určí název úlohy a parametr PSPrivateMetadata pracovního postupu k zadání vlastního ID. Třetí příkaz pomocí parametru FilterGet-Job získá úlohu podle vlastního ID zadaného v parametru PSPrivateMetadata.

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

Příklad 11: Získání informací o podřízených úlohách

Tento příklad ukazuje účinek použití IncludeChildJob a ChildJobState parametry rutiny Get-Job.

První příkaz získá úlohy v aktuální relaci. Výstup zahrnuje úlohu na pozadí, vzdálenou úlohu a několik instancí naplánované úlohy. Zdá se, že vzdálená úloha Job4 selhala. Druhý příkaz používá IncludeChildJob parametr Get-Job. Výstup přidá podřízené úlohy všech úloh, které mají podřízené úlohy. V tomto případě upravený výstup ukazuje, že selhala pouze podřízená úloha Job5 úlohy Job4. Třetí příkaz používá parametr ChildJobState s hodnotou Failed.Výstup zahrnuje všechny nadřazené úlohy a pouze podřízené úlohy, které selhaly. Pátý příkaz používá vlastnost JobStateInfo úloh a jeho vlastnost Reason zjistit, proč Úloha5 selhala.

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.

Další informace najdete v tématu nápovědy about_Remote_Troubleshooting.

Parametry

-After

Získá dokončené úlohy, které skončily po zadaném datu a čase. Zadejte objekt DateTime, například objekt vrácený rutinou Get-Date nebo řetězcem, který lze převést na objekt DateTime, například Dec 1, 2012 2:00 AM nebo 11/06.

Tento parametr funguje pouze u vlastních typů úloh, jako jsou úlohy pracovního postupu a naplánované úlohy, které mají vlastnost EndTime. Nefunguje na standardních úlohách na pozadí, jako jsou úlohy vytvořené pomocí rutiny Start-Job. Informace o podpoře tohoto parametru najdete v tématu nápovědy pro typ úlohy.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Before

Získá dokončené úlohy, které skončily před zadaným datem a časem. Zadejte objekt DateTime.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	DateTime
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ChildJobState

Získá pouze podřízené úlohy, které mají zadaný stav. Přijatelné hodnoty pro tento parametr jsou:

NotStarted
Tekoucí
Hotový
Neúspěšný
Zastavený
Blokovaný
Pozastavený
Nesouvislý
Pozastavení
Zastavení

Ve výchozím nastavení Get-Job nezískute podřízené úlohy. Pomocí parametru IncludeChildJob získá Get-Job všechny podřízené úlohy. Pokud použijete parametr ChildJobState, parametr IncludeChildJob nemá žádný vliv.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	JobState
Přípustné hodnoty:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Command

Určuje pole příkazů jako řetězce. Tato rutina získá úlohy, které obsahují zadané příkazy. Výchozí hodnota je všechny úlohy. K zadání vzoru příkazu můžete použít zástupné znaky.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-Filter

Určuje tabulku hodnot hash podmínek. Tato rutina získá úlohy, které splňují všechny podmínky. Zadejte tabulku hash, kde klíče jsou vlastnosti úlohy a hodnoty jsou hodnoty vlastností úlohy.

Tento parametr funguje jenom u vlastních typů úloh, jako jsou úlohy pracovního postupu a naplánované úlohy. Nefunguje na standardních úlohách na pozadí, jako jsou úlohy vytvořené pomocí rutiny Start-Job. Informace o podpoře tohoto parametru najdete v tématu nápovědy pro typ úlohy.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Hashtable
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-HasMoreData

Určuje, zda tato rutina získá pouze úlohy, které mají zadanou hodnotu vlastnosti HasMoreData. Vlastnost HasMoreData označuje, zda byly v aktuální relaci přijaty všechny výsledky úlohy. Pokud chcete získat úlohy, které mají více výsledků, zadejte hodnotu $True. Chcete-li získat úlohy, které nemají více výsledků, zadejte hodnotu $False.

Pokud chcete získat výsledky úlohy, použijte rutinu Receive-Job.

Když použijete rutinu Receive-Job, odstraní se z úložiště specifického pro danou relaci z úložiště v paměti výsledky, které vrátil. Když vrátí všechny výsledky úlohy v aktuální relaci, nastaví hodnotu vlastnosti HasMoreData úlohy na $False) tak, aby značila, že pro úlohu v aktuální relaci nemá žádné další výsledky. Pomocí parametru KeepReceive-Job zabráníte odstranění výsledků Receive-Job a změně hodnoty vlastnosti HasMoreData. Další informace potřebujete zadáním Get-Help Receive-Job.

Vlastnost HasMoreData je specifická pro aktuální relaci. Pokud jsou výsledky pro vlastní typ úlohy uloženy mimo relaci, například typ naplánované úlohy, který ukládá výsledky úloh na disk, můžete použít rutinu Receive-Job v jiné relaci k opětovnému získání výsledků úlohy, i když je hodnota HasMoreData$False. Další informace najdete v tématech nápovědy pro vlastní typ úlohy.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Id

Určuje pole ID úloh, které tato rutina získá.

ID je celé číslo, které jednoznačně identifikuje úlohu v aktuální relaci. Je jednodušší zapamatovat a zadat než ID instance, ale je jedinečné pouze v aktuální relaci. Můžete zadat jedno nebo více ID oddělených čárkami. Pokud chcete najít ID úlohy, zadejte Get-Job bez parametrů.

Typ:	Int32[]
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-IncludeChildJob

Označuje, že tato rutina kromě nadřazených úloh vrací podřízené úlohy.

Tento parametr je zvlášť užitečný pro zkoumání úloh pracovního postupu, pro které Get-Job vrací nadřazenou úlohu kontejneru a selhání úloh, protože důvod selhání je uložen ve vlastnosti podřízené úlohy.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InstanceId

Určuje pole ID instancí úloh, které tato rutina získá. Výchozí hodnota je všechny úlohy.

ID instance je identifikátor GUID, který jednoznačně identifikuje úlohu v počítači. K vyhledání ID instance úlohy použijte Get-Job.

Typ:	Guid[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Určuje pole popisných názvů instancí úloh, které tato rutina získá. Zadejte název úlohy nebo pomocí zástupných znaků zadejte vzor názvu úlohy. Ve výchozím nastavení Get-Job získá všechny úlohy v aktuální relaci.

Typ:	String[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	True

-Newest

Určuje počet úloh, které se mají získat. Tato rutina získá úlohy, které skončily naposledy.

Parametr Nejnovější neřadí nebo nevrací nejnovější úlohy v pořadí ukončení. Pokud chcete seřadit výstup, použijte rutinu Sort-Object.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-State

Určuje stav úlohy. Tato rutina získá pouze úlohy v zadaném stavu. Přijatelné hodnoty pro tento parametr jsou:

NotStarted
Tekoucí
Hotový
Neúspěšný
Zastavený
Blokovaný
Pozastavený
Nesouvislý
Pozastavení
Zastavení

Ve výchozím nastavení Get-Job získá všechny úlohy v aktuální relaci.

Další informace o stavech úloh naleznete v tématu JobState Výčtu.

Typ:	JobState
Přípustné hodnoty:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

System.Management.Automation.RemotingJob

Tato rutina vrací objekty, které představují úlohy v relaci.

Poznámky

PowerShell obsahuje následující aliasy pro Get-Job:

Všechny platformy:
- gjb

Vlastnost PSJobTypeName úloh označuje typ úlohy. Hodnota vlastnosti je určena autorem typu úlohy. Následující seznam obsahuje běžné typy úloh.

BackgroundJob. Místní úloha spuštěná pomocí Start-Job.
RemoteJob. Úloha spuštěná v PSSession pomocí parametru AsJob rutiny Invoke-Command.
PSWorkflowJob . Úloha byla zahájena pomocí AsJob společný parametr pracovních postupů.

Sdílet prostřednictvím

Get-Job

Syntaxe

Description

Příklady

Příklad 1: Zahájení všech úloh na pozadí v aktuální relaci

Příklad 2: Zastavení úlohy pomocí ID instance

Příklad 3: Získání úloh, které obsahují konkrétní příkaz

Příklad 4: Získání úloh, které obsahují konkrétní příkaz pomocí kanálu

Příklad 5: Získání úloh, které nebyly spuštěny

Příklad 6: Získání úloh, které nemají přiřazený název

Příklad 7: Použití objektu úlohy k reprezentaci úlohy v příkazu

Příklad 8: Získání všech úloh včetně úloh spuštěných jinou metodou

Příklad 9: Prozkoumání neúspěšné úlohy

Příklad 10: Získání filtrovaných výsledků

Příklad 11: Získání informací o podřízených úlohách

Parametry

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Get-Job

Syntaxe

Description

Příklady

Příklad 1: Zahájení všech úloh na pozadí v aktuální relaci

Příklad 2: Zastavení úlohy pomocí ID instance

Příklad 3: Získání úloh, které obsahují konkrétní příkaz

Příklad 4: Získání úloh, které obsahují konkrétní příkaz pomocí kanálu

Příklad 5: Získání úloh, které nebyly spuštěny

Příklad 6: Získání úloh, které nemají přiřazený název

Příklad 7: Použití objektu úlohy k reprezentaci úlohy v příkazu

Příklad 8: Získání všech úloh včetně úloh spuštěných jinou metodou

Příklad 9: Prozkoumání neúspěšné úlohy

Příklad 10: Získání filtrovaných výsledků

Příklad 11: Získání informací o podřízených úlohách

Parametry

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály