Get-Job

Pobiera zadania w tle programu PowerShell uruchomione w bieżącej sesji.

Składnia

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

Opis

Polecenie Get-Job cmdlet pobiera obiekty reprezentujące zadania w tle, które zostały uruchomione w bieżącej sesji. Możesz użyć Get-Job polecenia , aby pobrać zadania, które zostały uruchomione przy użyciu polecenia cmdlet lub za pomocą parametru Start-JobAsJob dowolnego polecenia cmdlet.

Bez parametrów Get-Job polecenie pobiera wszystkie zadania w bieżącej sesji. Możesz użyć parametrów polecenia Get-Job , aby uzyskać określone zadania.

Zwracany obiekt Get-Job zadania zawiera przydatne informacje o zadaniu, ale nie zawiera wyników zadania. Aby uzyskać wyniki, użyj Receive-Job polecenia cmdlet .

Zadanie Windows PowerShell w tle to polecenie uruchamiane w tle bez interakcji z bieżącą sesją. Zazwyczaj zadanie w tle służy do uruchamiania złożonego polecenia, które trwa długo. Aby uzyskać więcej informacji na temat zadań w tle w Windows PowerShell, zobacz about_Jobs.

Począwszy od Windows PowerShell 3.0, Get-Job polecenie cmdlet pobiera również niestandardowe typy zadań, takie jak zadania przepływu pracy i wystąpienia zaplanowanych zadań. Aby znaleźć typ zadania, użyj właściwości PSJobTypeName zadania.

Aby włączyć Get-Job pobieranie niestandardowego typu zadania, zaimportuj moduł obsługujący typ zadania niestandardowego do sesji przed uruchomieniem Get-Job polecenia za pomocą Import-Module polecenia cmdlet lub przy użyciu polecenia cmdlet lub pobierania polecenia cmdlet w module. Aby uzyskać informacje na temat określonego niestandardowego typu zadania, zobacz dokumentację funkcji niestandardowego typu zadania.

Przykłady

Przykład 1. Pobieranie wszystkich zadań w tle uruchomionych w bieżącej sesji

To polecenie pobiera wszystkie zadania w tle uruchomione w bieżącej sesji. Nie obejmuje zadań utworzonych w innych sesjach, nawet jeśli zadania są uruchamiane na komputerze lokalnym.

PS C:\> Get-Job

Przykład 2: Zatrzymywanie zadania przy użyciu identyfikatora wystąpienia

Te polecenia pokazują, jak pobrać identyfikator wystąpienia zadania, a następnie użyć go do zatrzymania zadania. W przeciwieństwie do nazwy zadania, które nie jest unikatowe, identyfikator wystąpienia jest unikatowy.

Pierwsze polecenie używa Get-Job polecenia cmdlet do pobrania zadania. Używa parametru Name do identyfikowania zadania. Polecenie przechowuje obiekt zadania zwracany Get-Job w zmiennej $j . W tym przykładzie istnieje tylko jedno zadanie o określonej nazwie. Drugie polecenie pobiera właściwość InstanceId obiektu w zmiennej $j i przechowuje ją w zmiennej $ID . Trzecie polecenie wyświetla wartość zmiennej $ID . Czwarte polecenie używa Stop-Job polecenia cmdlet do zatrzymania zadania. Używa parametru InstanceId do identyfikowania zadania i $ID zmiennej do reprezentowania identyfikatora wystąpienia zadania.

PS C:\> $j = Get-Job -Name Job1
PS C:\> $ID = $j.InstanceID
PS C:\> $ID

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

PS C:\> Stop-Job -InstanceId $ID

Przykład 3. Pobieranie zadań zawierających określone polecenie

To polecenie pobiera zadania w systemie, które zawierają Get-Process polecenie. Polecenie używa parametru Command parametru , Get-Job aby ograniczyć pobrane zadania. Polecenie używa symboli wieloznacznych (*) do pobierania zadań zawierających Get-Process polecenie w dowolnym miejscu w ciągu polecenia.

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

Przykład 4. Pobieranie zadań zawierających określone polecenie przy użyciu potoku

Podobnie jak polecenie w poprzednim przykładzie, to polecenie pobiera zadania w systemie, które zawierają Get-Process polecenie. Polecenie używa operatora potoku (|) do wysyłania ciągu w cudzysłowie do Get-Job polecenia cmdlet. Jest to odpowiednik poprzedniego polecenia.

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

Przykład 5. Pobieranie zadań, które nie zostały uruchomione

To polecenie pobiera tylko te zadania, które zostały utworzone, ale nie zostały jeszcze uruchomione. Obejmuje to zadania, które mają zostać uruchomione w przyszłości, i te, które nie zostały jeszcze zaplanowane.

PS C:\> Get-Job -State NotStarted

Przykład 6. Pobieranie zadań, do których nie przypisano nazwy

To polecenie pobiera wszystkie zadania, które mają nazwy zadań rozpoczynających się od zadania. Ponieważ job<number> jest to domyślna nazwa zadania, to polecenie pobiera wszystkie zadania, które nie mają jawnie przypisanej nazwy.

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

Przykład 7. Użycie obiektu zadania do reprezentowania zadania w poleceniu

W tym przykładzie pokazano, jak użyć Get-Job polecenia w celu pobrania obiektu zadania, a następnie pokazano, jak używać obiektu zadania do reprezentowania zadania w poleceniu.

Pierwsze polecenie używa Start-Job polecenia cmdlet do uruchomienia zadania w tle, które uruchamia Get-Process polecenie na komputerze lokalnym. Polecenie używa parametru Name parametru , Start-Job aby przypisać przyjazną nazwę do zadania. Drugie polecenie używa Get-Job polecenia do pobrania zadania. Używa parametru Name parametru Get-Job , aby zidentyfikować zadanie. Polecenie zapisuje wynikowy obiekt zadania w zmiennej $j . Trzecie polecenie wyświetla wartość obiektu zadania w zmiennej $j . Wartość właściwości State pokazuje, że zadanie zostało ukończone. Wartość właściwości HasMoreData pokazuje, że są dostępne wyniki z zadania, które nie zostały jeszcze pobrane. Czwarte polecenie używa Receive-Job polecenia cmdlet , aby uzyskać wyniki zadania. Używa obiektu zadania w zmiennej $j do reprezentowania zadania. Możesz również użyć operatora potoku, aby wysłać obiekt zadania do Receive-Jobelementu .

PS C:\> Start-Job -ScriptBlock {Get-Process} -Name MyJob
PS C:\> $j = Get-Job -Name MyJob
PS C:\> $j
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
6      MyJob           BackgroundJob   Completed     True            localhost            Get-Process

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

Przykład 8. Pobieranie wszystkich zadań, w tym zadań rozpoczętych przez inną metodę

W tym przykładzie pokazano, że Get-Job polecenie cmdlet może pobrać wszystkie zadania, które zostały uruchomione w bieżącej sesji, nawet jeśli zostały uruchomione przy użyciu różnych metod.

Pierwsze polecenie używa Start-Job polecenia cmdlet do uruchomienia zadania na komputerze lokalnym. Drugie polecenie używa parametru Invoke-CommandAsJob polecenia cmdlet do uruchomienia zadania na komputerze S1. Mimo że polecenia w zadaniu są uruchamiane na komputerze zdalnym, obiekt zadania jest tworzony na komputerze lokalnym, aby zarządzać zadaniem za pomocą poleceń lokalnych. Trzecie polecenie używa Invoke-Command polecenia cmdlet do uruchomienia Start-Job polecenia na komputerze S2. Za pomocą tej metody obiekt zadania jest tworzony na komputerze zdalnym, więc do zarządzania zadaniem służy zdalne polecenia. Czwarte polecenie używa Get-Job polecenia do pobierania zadań przechowywanych na komputerze lokalnym. Właściwość PSJobTypeName zadań wprowadzona w Windows PowerShell 3.0 pokazuje, że zadanie lokalne uruchomione przy użyciu Start-Job polecenia cmdlet jest zadaniem w tle, a zadanie uruchomione w sesji zdalnej przy użyciu Invoke-Command polecenia cmdlet jest zadaniem zdalnym. Piąte polecenie używa Invoke-Command polecenia do uruchomienia Get-Job polecenia na komputerze S2. Przykładowe dane wyjściowe pokazują wyniki Get-Job polecenia. Na komputerze S2 zadanie wydaje się być zadaniem lokalnym. Nazwa komputera to localhost, a typ zadania to zadanie w tle. Aby uzyskać więcej informacji na temat uruchamiania zadań w tle na komputerach zdalnych, zobacz about_Remote_Jobs.

PS C:\> Start-Job -ScriptBlock {Get-EventLog System}
PS C:\> Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog System} -AsJob
PS C:\> Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog System}}
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

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

Przykład 9: Badanie zadania, które zakończyło się niepowodzeniem

To polecenie pokazuje, jak użyć obiektu zadania, który Get-Job powraca do zbadania, dlaczego zadanie nie powiodło się. Pokazuje również, jak uzyskać podrzędne zadania poszczególnych zadań.

Pierwsze polecenie używa Start-Job polecenia cmdlet do uruchomienia zadania na komputerze lokalnym. Zwracany obiekt Start-Job zadania pokazuje, że zadanie nie powiodło się. Wartość właściwości State to Niepowodzenie.

Drugie polecenie używa Get-Job polecenia cmdlet do pobrania zadania. Polecenie używa metody kropki, aby uzyskać wartość właściwości JobStateInfo obiektu. Używa operatora potoku do wysyłania obiektu we właściwości JobStateInfo do Format-List polecenia cmdlet, które formatuje wszystkie właściwości obiektu (*) na liście. Wynik Format-List polecenia pokazuje, że wartość właściwości Reason zadania jest pusta.

Trzecie polecenie bada więcej. Używa Get-Job polecenia , aby pobrać zadanie, a następnie używa operatora potoku do wysłania całego obiektu zadania do Format-List polecenia cmdlet, które wyświetla wszystkie właściwości zadania na liście. Wyświetlanie wszystkich właściwości w obiekcie zadania pokazuje, że zadanie zawiera zadanie podrzędne o nazwie Job2.

Czwarte polecenie używa Get-Job polecenia do pobrania obiektu zadania, który reprezentuje zadanie podrzędne Job2. Jest to zadanie, w którym polecenie rzeczywiście zostało uruchomione. Używa metody kropki, aby uzyskać właściwość Reason właściwości JobStateInfo . Wynik pokazuje, że zadanie nie powiodło się z powodu błędu odmowy dostępu. W takim przypadku użytkownik zapomniał użyć opcji Uruchom jako administrator podczas uruchamiania Windows PowerShell. Ponieważ zadania w tle korzystają z funkcji komunikacji zdalniej Windows PowerShell, komputer musi być skonfigurowany do komunikacji zdalnie w celu uruchomienia zadania, nawet gdy zadanie jest uruchamiane na komputerze lokalnym. Aby uzyskać informacje o wymaganiach dotyczących komunikacji wirtualnej w Windows PowerShell, zobacz about_Remote_Requirements. Aby uzyskać porady dotyczące rozwiązywania problemów, zobacz about_Remote_Troubleshooting.

PS C:\> Start-Job -ScriptBlock {Get-Process}
Id     Name       PSJobTypeName   State       HasMoreData     Location             Command
--     ----       -------------   -----       -----------     --------             -------
1      Job1       BackgroundJob   Failed      False           localhost            Get-Process

PS C:\> (Get-Job).JobStateInfo | Format-List -Property *
State  : Failed
Reason :

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  :

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.

Przykład 10: Pobieranie odfiltrowanych wyników

W tym przykładzie pokazano, jak za pomocą parametru Filter pobrać zadanie przepływu pracy. Parametr Filter wprowadzony w Windows PowerShell 3.0 jest prawidłowy tylko dla niestandardowych typów zadań, takich jak zadania przepływu pracy i zaplanowane zadania.

Pierwsze polecenie używa słowa kluczowego Workflow do utworzenia przepływu pracy WFProcess. Drugie polecenie używa parametru AsJob przepływu pracy WFProcess, aby uruchomić przepływ pracy jako zadanie w tle. Używa parametru JobName przepływu pracy do określenia nazwy zadania i parametru PSPrivateMetadata przepływu pracy w celu określenia niestandardowego identyfikatora. Trzecie polecenie używa parametru Filter parametru Get-Job , aby pobrać zadanie według identyfikatora niestandardowego określonego w parametrze PSPrivateMetadata .

PS C:\> Workflow WFProcess {Get-Process}
PS C:\> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
PS C:\> Get-Job -Filter @{MyCustomId = 92107}
Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
1      WFProcessJob    Completed     True            localhost            WFProcess

Przykład 11. Uzyskiwanie informacji o zadaniach podrzędnych

W tym przykładzie pokazano efekt użycia parametrów Get-JobIncludeChildJob i ChildJobState polecenia cmdlet.

Pierwsze polecenie pobiera zadania w bieżącej sesji. Dane wyjściowe obejmują zadanie w tle, zadanie zdalne i kilka wystąpień zaplanowanego zadania. Zadanie zdalne, Job4, wydaje się, że nie powiodło się. Drugie polecenie używa parametru IncludeChildJob parametru Get-Job. Dane wyjściowe dodają podrzędne zadania wszystkich zadań, które mają zadania podrzędne. W tym przypadku poprawione dane wyjściowe pokazują, że zadanie podrzędne job5 job4 nie powiodło się. Trzecie polecenie używa parametru ChildJobState z wartością Failed.Dane wyjściowe zawierają wszystkie zadania nadrzędne i tylko zadania podrzędne, które zakończyły się niepowodzeniem. Piąte polecenie używa właściwości JobStateInfo zadań i jej właściwości Reason , aby dowiedzieć się, dlaczego zadanie Job5 nie powiodło się.

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

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

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

PS C:\> (Get-Job -Name Job5).JobStateInfo.Reason
Connecting to remote server Server01 failed with the following error message:
Access is denied.

Aby uzyskać więcej informacji, zobacz temat pomocy about_Remote_Troubleshooting .

Parametry

-After

Pobiera ukończone zadania, które zakończyły się po określonej dacie i godzinie. Wprowadź obiekt DateTime , taki jak jeden zwrócony przez Get-Date polecenie cmdlet lub ciąg, który można przekonwertować na obiekt DateTime , taki jak Dec 1, 2012 2:00 AM lub 11/06.

Ten parametr działa tylko w przypadku niestandardowych typów zadań, takich jak zadania przepływu pracy i zaplanowane zadania, które mają właściwość EndTime . Nie działa on w przypadku standardowych zadań w tle, takich jak te utworzone przy użyciu Start-Job polecenia cmdlet . Aby uzyskać informacje o obsłudze tego parametru, zobacz temat pomocy dla typu zadania.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Before

Pobiera ukończone zadania, które zakończyły się przed określoną datą i godziną. Wprowadź obiekt DateTime .

Ten parametr działa tylko w przypadku niestandardowych typów zadań, takich jak zadania przepływu pracy i zaplanowane zadania, które mają właściwość EndTime . Nie działa on w przypadku standardowych zadań w tle, takich jak te utworzone przy użyciu Start-Job polecenia cmdlet . Aby uzyskać informacje o obsłudze tego parametru, zobacz temat pomocy dla typu zadania.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ChildJobState

Pobiera tylko zadania podrzędne, które mają określony stan. Dopuszczalne wartości dla tego parametru to:

  • Niestartowane
  • Uruchomienie
  • Ukończone
  • Niepowodzenie
  • Zatrzymano
  • Zablokowane
  • Suspended
  • Odłączony
  • Zawieszanie
  • Zatrzymywanie

Domyślnie Get-Job nie pobiera zadań podrzędnych. Za pomocą parametru Get-JobIncludeChildJob pobiera wszystkie zadania podrzędne. Jeśli używasz parametru ChildJobState , parametr IncludeChildJob nie ma wpływu.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:JobState
Accepted values:NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Command

Określa tablicę poleceń jako ciągów. To polecenie cmdlet pobiera zadania zawierające określone polecenia. Wartość domyślna to wszystkie zadania. Możesz użyć symboli wieloznacznych, aby określić wzorzec polecenia.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Filter

Określa tabelę skrótów warunków. To polecenie cmdlet pobiera zadania spełniające wszystkie warunki. Wprowadź tabelę skrótów, w której klucze są właściwościami zadania, a wartości to wartości właściwości zadania.

Ten parametr działa tylko w przypadku niestandardowych typów zadań, takich jak zadania przepływu pracy i zaplanowane zadania. Nie działa on w przypadku standardowych zadań w tle, takich jak te utworzone przy użyciu Start-Job polecenia cmdlet . Aby uzyskać informacje o obsłudze tego parametru, zobacz temat pomocy dla typu zadania.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:Hashtable
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-HasMoreData

Wskazuje, czy to polecenie cmdlet pobiera tylko zadania z określoną wartością właściwości HasMoreData . Właściwość HasMoreData wskazuje, czy wszystkie wyniki zadania zostały odebrane w bieżącej sesji. Aby uzyskać zadania, które mają więcej wyników, określ wartość .$True Aby uzyskać zadania, które nie mają większej liczby wyników, określ wartość .$False

Aby uzyskać wyniki zadania, użyj Receive-Job polecenia cmdlet .

Gdy używasz Receive-Job polecenia cmdlet, usuwa on dane z magazynu specyficznego dla sesji w pamięci, które zostały zwrócone. Gdy zwraca wszystkie wyniki zadania w bieżącej sesji, ustawia wartość właściwości HasMoreData zadania na wartość ), aby wskazać $False, że nie ma więcej wyników dla zadania w bieżącej sesji. Użyj parametru Keep , Receive-Job aby zapobiec Receive-Job usuwaniu wyników i zmienianiu wartości właściwości HasMoreData . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Receive-Job.

Właściwość HasMoreData jest specyficzna dla bieżącej sesji. Jeśli wyniki niestandardowego typu zadania są zapisywane poza sesją, takie jak typ zaplanowanego zadania, który zapisuje wyniki zadania na dysku, możesz użyć Receive-Job polecenia cmdlet w innej sesji, aby uzyskać wyniki zadania ponownie, nawet jeśli wartość HasMoreData to $False. Aby uzyskać więcej informacji, zobacz tematy pomocy dotyczące niestandardowego typu zadania.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Określa tablicę identyfikatorów zadań pobieranych przez to polecenie cmdlet.

Identyfikator jest liczbą całkowitą, która jednoznacznie identyfikuje zadanie w bieżącej sesji. Łatwiej jest zapamiętać i wpisać identyfikator wystąpienia, ale jest on unikatowy tylko w bieżącej sesji. Możesz wpisać jeden lub więcej identyfikatorów rozdzielonych przecinkami. Aby znaleźć identyfikator zadania, wpisz Get-Job bez parametrów.

Type:Int32[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IncludeChildJob

Wskazuje, że to polecenie cmdlet zwraca zadania podrzędne oprócz zadań nadrzędnych.

Ten parametr jest szczególnie przydatny do badania zadań przepływu pracy, dla których Get-Job zwraca zadanie nadrzędne kontenera i niepowodzenia zadań, ponieważ przyczyna niepowodzenia jest zapisywana we właściwości zadania podrzędnego.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InstanceId

Określa tablicę identyfikatorów wystąpień zadań pobieranych przez to polecenie cmdlet. Wartość domyślna to wszystkie zadania.

Identyfikator wystąpienia to identyfikator GUID, który jednoznacznie identyfikuje zadanie na komputerze. Aby znaleźć identyfikator wystąpienia zadania, użyj polecenia Get-Job.

Type:Guid[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa tablicę przyjaznych nazw wystąpień zadań pobieranych przez to polecenie cmdlet. Wprowadź nazwę zadania lub użyj symboli wieloznacznych, aby wprowadzić wzorzec nazwy zadania. Domyślnie Get-Job pobiera wszystkie zadania w bieżącej sesji.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Newest

Określa liczbę zadań do pobrania. To polecenie cmdlet pobiera ostatnio zakończone zadania.

Najnowszy parametr nie sortuje ani nie zwraca najnowszych zadań w kolejności czasu końcowego. Aby posortować dane wyjściowe, użyj Sort-Object polecenia cmdlet .

Ten parametr został wprowadzony w Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-State

Określa stan zadania. To polecenie cmdlet pobiera tylko zadania w określonym stanie. Dopuszczalne wartości dla tego parametru to:

  • Niestartowane
  • Uruchomienie
  • Ukończone
  • Niepowodzenie
  • Zatrzymano
  • Zablokowane
  • Suspended
  • Odłączony
  • Zawieszanie
  • Zatrzymywanie

Domyślnie Get-Job pobiera wszystkie zadania w bieżącej sesji.

Aby uzyskać więcej informacji na temat stanów zadań, zobacz JobState Enumeration (Wyliczenie JobState).

Type:JobState
Accepted values:NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

None

Nie można przekazać potoku danych wejściowych do tego polecenia cmdlet.

Dane wyjściowe

System.Management.Automation.RemotingJob

To polecenie cmdlet zwraca obiekty reprezentujące zadania w sesji.

Uwagi

Właściwość PSJobTypeName zadań wskazuje typ zadania. Wartość właściwości jest określana przez autora typu zadania. Na poniższej liście przedstawiono typowe typy zadań.

  • BackgroundJob. Zadanie lokalne uruchomione przy użyciu polecenia Start-Job.
  • RemoteJob. Zadanie uruchomione w programie PSSession przy użyciu parametru Invoke-CommandAsJob polecenia cmdlet.
  • PSWorkflowJob. Zadanie rozpoczęte przy użyciu wspólnego parametru asJob przepływów pracy.