about_Jobs
Krótki opis
Zawiera informacje o tym, jak zadania w tle programu PowerShell uruchamiają polecenie lub wyrażenie w tle bez interakcji z bieżącą sesją.
Długi opis
Program PowerShell współbieżnie uruchamia polecenia i skrypty za pomocą zadań. Istnieją trzy typy zadań udostępniane przez program PowerShell do obsługi współbieżności.
RemoteJob- Polecenia i skrypty uruchamiane w sesji zdalnej. Aby uzyskać informacje, zobacz about_Remote_Jobs.BackgroundJob— Polecenia i skrypty są uruchamiane w osobnym procesie na komputerze lokalnym.PSTaskJoborThreadJob— polecenia i skrypty są uruchamiane w osobnym wątku w ramach tego samego procesu na komputerze lokalnym. Aby uzyskać więcej informacji, zobacz about_Thread_Jobs.
Zdalne uruchamianie skryptów na oddzielnej maszynie lub w osobnym procesie zapewnia doskonałą izolację. Wszelkie błędy występujące w zadaniu zdalnym nie mają wpływu na inne uruchomione zadania lub sesję nadrzędną, która uruchomiła zadanie. Jednak warstwa komunikacji sieciowej dodaje obciążenie, w tym serializacji obiektów. Wszystkie obiekty są serializowane i deserializowane, ponieważ są przekazywane między sesją nadrzędną a sesją zdalną (zadanie). Serializacja dużych złożonych obiektów danych może zużywać duże ilości zasobów obliczeniowych i pamięci oraz transferować duże ilości danych w sieci.
Zadania oparte na wątkach nie są tak niezawodne, jak zadania zdalne i w tle, ponieważ są uruchamiane w tym samym procesie w różnych wątkach. Jeśli jedno zadanie ma krytyczny błąd powodujący awarię procesu, wszystkie inne zadania w procesie zostaną zakończone.
Jednak zadania oparte na wątkach wymagają mniejszego nakładu pracy. Nie używają warstwy komunikacji sieciowej ani serializacji. Obiekty wynikowe są zwracane jako odwołania do obiektów na żywo w bieżącej sesji. Bez tego obciążenia zadania oparte na wątkach działają szybciej i używają mniejszej liczby zasobów niż inne typy zadań.
Ważne
Sesja nadrzędna, która utworzyła zadanie, monitoruje również stan zadania i zbiera dane potoku. Proces podrzędny zadania jest przerywany przez proces nadrzędny po osiągnięciu stanu zakończenia zadania. Jeśli sesja nadrzędna zostanie zakończona, wszystkie uruchomione zadania podrzędne zostaną zakończone wraz z procesami podrzędnymi.
Istnieją dwa sposoby obejścia tej sytuacji:
- Służy
Invoke-Commanddo tworzenia zadań uruchamianych w sesjach rozłączonych. Aby uzyskać więcej informacji, zobacz about_Remote_Jobs. - Użyj polecenia
Start-Process, aby utworzyć nowy proces, a nie zadanie. Aby uzyskać więcej informacji, zobacz Rozpoczęcie procesu.
Polecenia cmdlet zadania
| Polecenie cmdlet | Opis |
|---|---|
Start-Job |
Uruchamia zadanie w tle na komputerze lokalnym. |
Get-Job |
Pobiera zadania w tle, które zostały uruchomione w obiekcie |
| bieżąca sesja. | |
Receive-Job |
Pobiera wyniki zadań w tle. |
Stop-Job |
Zatrzymuje zadanie w tle. |
Wait-Job |
Pomija wiersz polecenia do momentu, gdy jedno lub wszystkie zadania zostaną pominięte |
| Kompletny. | |
Remove-Job |
Usuwa zadanie w tle. |
Invoke-Command |
Parametr AsJob tworzy zadanie w tle w obiekcie |
komputer zdalny. Aby uruchomić polecenie , możesz użyć polecenia Invoke-Command |
|
dowolne polecenie zadania zdalnie, w tym Start-Job. |
Jak uruchomić zadanie na komputerze lokalnym
Aby uruchomić zadanie w tle na komputerze lokalnym, użyj Start-Job polecenia cmdlet .
Aby napisać Start-Job polecenie, należy ująć polecenie, które zadanie jest uruchamiane w nawiasach klamrowych ({}). Użyj parametru ScriptBlock , aby określić polecenie.
Następujące polecenie uruchamia zadanie w tle, które uruchamia Get-Process polecenie na komputerze lokalnym.
Start-Job -ScriptBlock {Get-Process}
Po uruchomieniu zadania w tle wiersz polecenia zostanie zwrócony natychmiast, nawet jeśli zadanie potrwa dłuższy czas. Możesz kontynuować pracę w sesji bez przerwy podczas uruchamiania zadania.
Polecenie Start-Job zwraca obiekt reprezentujący zadanie. Obiekt zadania zawiera przydatne informacje o zadaniu, ale nie zawiera wyników zadania.
Obiekt zadania można zapisać w zmiennej, a następnie użyć go z innymi poleceniami cmdlet zadania do zarządzania zadaniem w tle. Następujące polecenie uruchamia obiekt zadania i zapisuje wynikowy obiekt zadania w zmiennej $job .
$job = Start-Job -ScriptBlock {Get-Process}
Począwszy od programu PowerShell 6.0, możesz użyć operatora w tle (&) na końcu potoku, aby uruchomić zadanie w tle. Aby uzyskać więcej informacji, zobacz operator tła.
Użycie operatora w tle jest funkcjonalnie równoważne z użyciem Start-Job polecenia cmdlet w poprzednim przykładzie.
$job = Get-Process &
Pobieranie obiektów zadań
Polecenie Get-Job cmdlet zwraca obiekty reprezentujące zadania w tle, które zostały uruchomione w bieżącej sesji. Bez parametrów Get-Job zwraca wszystkie zadania uruchomione w bieżącej sesji.
Get-Job
Obiekt zadania zawiera stan zadania, który wskazuje, czy zadanie zostało zakończone. Ukończone zadanie ma stan Ukończono lub Niepowodzenie. Zadanie może być również zablokowane lub uruchomione.
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
Obiekt zadania można zapisać w zmiennej i użyć go do reprezentowania zadania w późniejszym poleceniu. Następujące polecenie pobiera zadanie o identyfikatorze 1 i zapisuje je w zmiennej $job .
$job = Get-Job -Id 1
Pobieranie wyników zadania
Po uruchomieniu zadania w tle wyniki nie są wyświetlane natychmiast. Aby uzyskać wyniki zadania w tle, użyj Receive-Job polecenia cmdlet .
W poniższym przykładzie Receive-Job polecenie cmdlet pobiera wyniki zadania przy użyciu obiektu zadania w zmiennej $job .
Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
668 7 2672 6168 104 32.26 488 csrss
...
Wyniki zadania można zapisać w zmiennej. Następujące polecenie zapisuje wyniki zadania w zmiennej $job do zmiennej $results .
$results = Receive-Job -Job $job
Pobieranie i utrzymywanie wyników częściowych zadań
Polecenie Receive-Job cmdlet pobiera wyniki zadania w tle. Jeśli zadanie zostało ukończone, Receive-Job pobiera wszystkie wyniki zadania. Jeśli zadanie jest nadal uruchomione, Receive-Job pobiera wyniki, które zostały wygenerowane do tej pory. Aby uzyskać pozostałe wyniki, możesz ponownie uruchomić Receive-Job polecenia.
Domyślnie usuwa wyniki z pamięci podręcznej, Receive-Job w której są przechowywane wyniki zadania. Po ponownym uruchomieniu Receive-Job uzyskasz tylko nowe wyniki, które dotarły po pierwszym uruchomieniu.
Następujące polecenia pokazują wyniki poleceń uruchamianych Receive-Job przed ukończeniem zadania.
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Użyj parametru Keep , aby zapobiec Receive-Job usunięciu zwracanych wyników zadania. Poniższe polecenia pokazują efekt użycia parametru Keep w zadaniu, które nie zostało jeszcze ukończone.
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Oczekiwanie na wyniki
Jeśli uruchamiasz polecenie, które trwa długo, możesz użyć właściwości obiektu zadania, aby określić, kiedy zadanie zostało ukończone. Następujące polecenie używa obiektu, Get-Job aby pobrać wszystkie zadania w tle w bieżącej sesji.
Get-Job
Wyniki są wyświetlane w tabeli. Stan zadania jest wyświetlany w kolumnie Stan .
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
2 Job2 BackgroundJob Running True localhost Get-EventLog -Log ...
3 Job3 BackgroundJob Complete True localhost dir -Path C:\* -Re...
W tym przypadku właściwość State ujawnia, że zadanie 2 jest nadal uruchomione. Jeśli chcesz użyć Receive-Job polecenia cmdlet , aby uzyskać wyniki zadania teraz, wyniki będą niekompletne. Możesz wielokrotnie używać Receive-Job polecenia cmdlet, aby uzyskać wszystkie wyniki. Użyj właściwości State , aby określić, kiedy zadanie zostało ukończone.
Można również użyć parametru Receive-JobWait polecenia cmdlet. W przypadku użycia tego parametru polecenie cmdlet nie zwraca wiersza polecenia, dopóki zadanie nie zostanie ukończone, a wszystkie wyniki będą dostępne.
Możesz również użyć Wait-Job polecenia cmdlet , aby poczekać na dowolne lub wszystkie wyniki zadania. Wait-Job umożliwia oczekiwanie na jedno lub więcej konkretnych zadań lub dla wszystkich zadań.
Następujące polecenie używa Wait-Job polecenia cmdlet do oczekiwania na zadanie o identyfikatorze 10.
Wait-Job -ID 10
W związku z tym monit programu PowerShell jest pomijany do momentu ukończenia zadania.
Możesz również poczekać na wstępnie określony okres czasu. To polecenie używa parametru Limit czasu , aby ograniczyć czas oczekiwania do 120 sekund. Po wygaśnięciu czasu zostanie zwrócony wiersz polecenia, ale zadanie będzie nadal działać w tle.
Wait-Job -ID 10 -Timeout 120
Zatrzymywanie zadania
Aby zatrzymać zadanie w tle, użyj Stop-Job polecenia cmdlet . Następujące polecenie uruchamia zadanie, aby pobrać każdy wpis w dzienniku zdarzeń systemu. Zapisuje obiekt zadania w zmiennej $job .
$job = Start-Job -ScriptBlock {Get-EventLog -Log System}
Następujące polecenie zatrzymuje zadanie. Używa operatora potoku (|), aby wysłać zadanie w zmiennej $job do Stop-Job.
$job | Stop-Job
Usuwanie zadania
Aby usunąć zadanie w tle, użyj Remove-Job polecenia cmdlet . Następujące polecenie usuwa zadanie w zmiennej $job .
Remove-Job -Job $job
Badanie zadania, które zakończyło się niepowodzeniem
Zadania mogą zakończyć się niepowodzeniem z wielu powodów. obiekt zadania zawiera właściwość Reason , która zawiera informacje o przyczynie błędu.
Poniższy przykład uruchamia zadanie bez wymaganych poświadczeń.
$job = Start-Job -ScriptBlock {New-Item -Path HKLM:\Software\MyCompany}
Get-Job $job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost New-Item -Path HKLM:...
Sprawdź właściwość Reason , aby znaleźć błąd, który spowodował niepowodzenie zadania.
$job.ChildJobs[0].JobStateInfo.Reason
W takim przypadku zadanie nie powiodło się, ponieważ komputer zdalny wymagał poświadczeń jawnych do uruchomienia polecenia. Właściwość Reason zawiera następujący komunikat:
Nawiązywanie połączenia z serwerem zdalnym nie powiodło się z powodu następującego komunikatu o błędzie: "Odmowa dostępu".