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. Můžete použít Get-Job k získání úloh, které byly spuštěny pomocí Start-Job rutiny, nebo pomocí parametru AsJob libovolné rutiny.

Bez parametrů Get-Job získá příkaz 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 najdete v tématu about_Jobs.

Počínaje windows PowerShellem 3.0 Get-Job získá rutina 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ískání vlastního typu úlohy, naimportujte modul, který podporuje vlastní typ úlohy, před spuštěním Get-Job příkazu pomocí rutiny Import-Module nebo pomocí rutiny nebo získáním 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 se vrátí do $j proměnné. V tomto příkladu existuje pouze jedna úloha se zadaným názvem. Druhý příkaz získá Vlastnost InstanceId objektu v $j proměnné a uloží ji do $ID proměnné. Třetí příkaz zobrazí hodnotu $ID proměnné. Čtvrtý příkaz používá Stop-Job rutinu k zastavení úlohy. Pomocí parametru InstanceId identifikuje úlohu a $ID proměnnou, která představuje 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ý obsahuje Get-Process příkaz. Příkaz používá k omezení načtených úloh parametr Get-Job Command. Příkaz používá zástupné znaky (*) k získání úloh, které obsahují Get-Process příkaz kdekoli v řetězci příkazu.

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

Stejně jako příkaz v předchozím příkladu získá tento příkaz úlohy v systému, který obsahuje Get-Process příkaz. Příkaz pomocí operátoru kanálu (|) odešle rutině Get-Job PSCustomObject s příkazem NoteProperty. 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. Vzhledem k tomu job<number> , že je výchozí název ú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 získat Get-Job 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í Get-Process příkaz v místním počítači. Příkaz používá parametr Start-Job Name pro přiřazení popisného názvu k úloze. Druhý příkaz použije Get-Job k získání úlohy. K identifikaci úlohy používá parametr Get-Job Name. Příkaz uloží výsledný objekt úlohy do $j proměnné. Třetí příkaz zobrazí hodnotu objektu úlohy v $j proměnné. Hodnota state vlastnost 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 pomocí rutiny Receive-Job získá výsledky úlohy. Používá objekt úlohy v $j proměnné k reprezentaci úlohy. Operátor kanálu můžete použít také 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 pomocí rutiny Start-Job spustí úlohu v místním počítači. Druhý příkaz pomocí parametru Invoke-Command AsJob rutiny spustí úlohu 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 Start-Job ke spuštění příkazu 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í Start-Job rutiny je úloha na pozadí a úloha spuštěná ve vzdálené relaci pomocí Invoke-Command rutiny 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í Get-Job příkazu na počítači S2 pomocí psSession. Ukázkový výstup ukazuje výsledky Get-Job příkazu. 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 najdete 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 použít objekt úlohy, který Get-Job se vrátí k prozkoumání, proč úloha selhala. Také ukazuje, jak získat podřízené úlohy každé úlohy.

První příkaz pomocí rutiny Start-Job spustí úlohu v místním počítači. Objekt úlohy, který Start-Job vrátí, ukazuje, že úloha selhala. Hodnota state vlastnost je Failed.

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

Třetí příkaz prozkoumá více. Pomocí příkazu získá úlohu a pak pomocí Get-Job operátoru kanálu odešle do rutiny celý objekt Format-List úlohy, 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. Používá 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 na vzdálené komunikace v prostředí Windows PowerShell 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 Pracovní postup k vytvoření pracovního postupu WFProcess. Druhý příkaz používá parametr AsJob pracovního postupu WFProcess ke spuštění pracovního postupu jako úlohu 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 Get-Job Filter 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í parametrů IncludeChildJob a ChildJobState 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á parametr IncludeChildJob parametru 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á JobStateInfo vlastnost úloh a jeho Reason vlastnost zjistit, proč Job5 selhal.

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ý Get-Date rutinou 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. Tento parametr přijímá tyto hodnoty:

NotStarted
Spuštěno
Dokončeno
Neúspěšný
Zastaveno
Blokované
Dočasně blokován.
Odpojeno
Pozastavení
Zastavování

Ve výchozím nastavení Get-Job nezískute podřízené úlohy. Pomocí parametru Get-Job IncludeChildJob získá 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 . HasMoreData vlastnost označuje, zda byly všechny výsledky úlohy přijaty v aktuální relaci. Chcete-li 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 HasMoreData úlohy na $False) tak, aby značila, že nemá žádné další výsledky pro úlohu v aktuální relaci. Pomocí keep parametru Receive-Job zabránit Receive-Job odstranění výsledků a změnit hodnotu HasMoreData vlastnost. 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 úlohy na disk, můžete pomocí rutiny Receive-Job v jiné relaci získat výsledky úlohy znovu, i když je $Falsehodnota HasMoreData . 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.

Nejnovější parametr 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. Tento parametr přijímá tyto hodnoty:

NotStarted
Spuštěno
Dokončeno
Neúspěšný
Zastaveno
Blokované
Dočasně blokován.
Odpojeno
Pozastavení
Zastavování

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

Další informace o stavech úloh naleznete v části JobState – výčet.

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.

Úloha pozadí Místní úloha byla spuštěna pomocí .Start-Job
Vzdálená úloha. Úloha spuštěná v PSSession pomocí parametru AsJob rutiny Invoke-Command .
PSWorkflowJob. Úloha byla zahájena pomocí společného parametru AsJob 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