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>]
   [-State] <JobState>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Name] <String[]>
   [<CommonParameters>]

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

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 najdete 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, do relace před spuštěním příkazu Get-Job buď pomocí rutiny Import-Module, nebo pomocí 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

PS C:\> Get-Job

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.

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

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

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

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

PS C:\> Get-Job -Command "*get-process*"

Tento příkaz získá úlohy v systému, které obsahují příkaz Get-Process. Příkaz používá Command parametr Get-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.

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

PS C:\> "*get-process*" | Get-Job

Stejně 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 používá operátor kanálu (|) k odeslání řetězce v uvozovkách do rutiny Get-Job. Je to ekvivalent předchozího příkazu.

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

PS C:\> Get-Job -State NotStarted

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

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

PS C:\> Get-Job -Name Job*

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

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

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

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

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

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

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.

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

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.

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

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

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

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.

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

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.

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

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. Pokud chcete 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 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 vlastnosti úlohy na $False) tak, aby značila, že pro úlohu v aktuální relaci nemá žádné další výsledky. Pomocí parametru Keep Receive-Job zabráníte Receive-Job odstranit výsledky a změnit hodnotu 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, aby se výsledky úlohy znovu získaly, 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áště 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ýčet v knihovně MSDN.

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

Vstup do této rutiny nelze převést.

Výstupy

System.Management.Automation.RemotingJob

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

Poznámky

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 byla spuštěna 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