Stop-Job

Stop-Job
    [-Id] <Int32[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-Job] <Job[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-Name] <String[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-InstanceId] <Guid[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-State] <JobState>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-Filter] <Hashtable>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Polecenie cmdlet Stop-Job zatrzymuje zadania w tle programu PowerShell, które są w toku. To polecenie cmdlet umożliwia zatrzymanie wszystkich zadań lub zatrzymanie wybranych zadań na podstawie ich nazwy, identyfikatora, identyfikatora wystąpienia lub stanu albo przekazanie obiektu zadania do Stop-Job.

Za pomocą Stop-Job można zatrzymać zadania w tle, takie jak te, które zostały uruchomione przy użyciu polecenia cmdlet Start-Job lub AsJob parametru dowolnego polecenia cmdlet. Po zatrzymaniu zadania w tle program PowerShell wykonuje wszystkie zadania oczekujące w tej kolejce zadań, a następnie kończy zadanie. Po przesłaniu tego polecenia żadne nowe zadania nie są dodawane do kolejki.

To polecenie cmdlet nie usuwa zadań w tle. Aby usunąć zadanie, użyj polecenia cmdlet Remove-Job.

Począwszy od programu Windows PowerShell 3.0, Stop-Job również zatrzymuje niestandardowe typy zadań, takie jak WorkflowJobs i wystąpienia ScheduledJobs. Aby włączyć Stop-Job zatrzymać zadanie z niestandardowym typem zadania, zaimportuj moduł obsługujący niestandardowy typ zadania do sesji przed uruchomieniem polecenia Stop-Job za pomocą polecenia cmdlet Import-Module lub polecenia cmdlet lub pobierania polecenia cmdlet w module. Aby uzyskać informacje na temat określonego niestandardowego typu zadania, zobacz dokumentację funkcji niestandardowego typu zadania.

$s = New-PSSession -ComputerName Server01 -Credential Domain01\Admin02
$j = Invoke-Command -Session $s -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Invoke-Command -Session $s -ScriptBlock { Stop-Job -Job $Using:j }

W tym przykładzie pokazano, jak użyć polecenia cmdlet Stop-Job, aby zatrzymać zadanie uruchomione na komputerze zdalnym.

Ponieważ zadanie zostało uruchomione za pomocą polecenia cmdlet Invoke-Command w celu zdalnego uruchomienia polecenia Start-Job, obiekt zadania jest przechowywany na komputerze zdalnym. Aby zdalnie uruchomić polecenie Invoke-Command, należy użyć innego polecenia Stop-Job. Aby uzyskać więcej informacji na temat zdalnych zadań w tle, zobacz about_Remote_Jobs.

Pierwsze polecenie tworzy sesję programu PowerShell (pssession) na komputerze Server01, a następnie przechowuje obiekt sesji w zmiennej $s. Polecenie używa poświadczeń administratora domeny.

Drugie polecenie używa polecenia cmdlet Invoke-Command do uruchomienia polecenia Start-Job w sesji. Polecenie w zadaniu pobiera wszystkie zdarzenia w dzienniku zdarzeń systemu. Wynikowy obiekt zadania jest przechowywany w zmiennej $j.

Trzecie polecenie zatrzymuje zadanie. Używa on polecenia cmdlet Invoke-Command do uruchomienia polecenia Stop-Job w PSSession na serwerze Server01. Ponieważ obiekty zadań są przechowywane w $j, która jest zmienną na komputerze lokalnym, polecenie używa modyfikatora zakresu Using: do identyfikowania $j jako zmiennej lokalnej. Aby uzyskać więcej informacji na temat Using: modyfikatora zakresu, zobacz about_Remote_Variables.

Po zakończeniu polecenia zadanie zostanie zatrzymane, a PSSession w $s jest dostępny do użycia.

Stop-Job -Name "Job1"

To polecenie zatrzymuje zadanie Job1 w tle.

Stop-Job -Id 1, 3, 4

To polecenie zatrzymuje trzy zadania. Identyfikuje je przy użyciu identyfikatorów .

Get-Job | Stop-Job

To polecenie zatrzymuje wszystkie zadania w tle w bieżącej sesji.

Stop-Job -State Blocked

To polecenie zatrzymuje wszystkie zablokowane zadania.

Get-Job | Format-Table ID, Name, Command, @{Label="State";Expression={$_.JobStateInfo.State}},
InstanceId -Auto

Id Name Command                 State  InstanceId
-- ---- -------                 -----  ----------
1 Job1 Start-Service schedule Running 05abb67a-2932-4bd5-b331-c0254b8d9146
3 Job3 Start-Service schedule Running c03cbd45-19f3-4558-ba94-ebe41b68ad03
5 Job5 Get-Service s*         Blocked e3bbfed1-9c53-401a-a2c3-a8db34336adf

Stop-Job -InstanceId e3bbfed1-9c53-401a-a2c3-a8db34336adf

Te polecenia pokazują, jak zatrzymać zadanie na podstawie InstanceId.

Pierwsze polecenie używa polecenia cmdlet Get-Job, aby pobrać zadania w bieżącej sesji. Polecenie używa operatora potoku (|) do wysyłania zadań do polecenia Format-Table, które wyświetla tabelę określonych właściwości każdego zadania. Tabela zawiera InstanceId każdego zadania. Używa właściwości obliczeniowej do wyświetlania stanu zadania.

Drugie polecenie używa polecenia Stop-Job, które ma parametr InstanceId, aby zatrzymać wybrane zadanie.

$j = Invoke-Command -ComputerName Server01 -ScriptBlock {Get-EventLog -LogName System} -AsJob
$j | Stop-Job -PassThru

Id    Name    State      HasMoreData     Location         Command
--    ----    ----       -----------     --------         -------
5     Job5    Stopped    True            user01-tablet    Get-EventLog -LogName Sy...

W tym przykładzie pokazano, jak użyć polecenia cmdlet Stop-Job, aby zatrzymać zadanie uruchomione na komputerze zdalnym.

Ponieważ zadanie zostało uruchomione z parametrem AsJob polecenia cmdlet Invoke-Command, obiekt Job znajduje się na komputerze lokalnym, mimo że zadanie jest uruchamiane na komputerze zdalnym. W związku z tym można użyć lokalnego polecenia Stop-Job, aby zatrzymać zadanie.

Pierwsze polecenie używa polecenia cmdlet Invoke-Command do uruchomienia zadania w tle na komputerze Server01. Polecenie używa parametru AsJob, aby uruchomić zdalne polecenie jako zadanie w tle.

To polecenie zwraca obiekt zadania, który jest tym samym obiektem zadania, który zwraca polecenie cmdlet Start-Job. Polecenie zapisuje obiekt zadania w zmiennej $j.

Drugie polecenie używa operatora potoku do wysyłania zadania w zmiennej $j do Stop-Job. Polecenie używa parametru PassThru, aby Stop-Job zwrócić obiekt zadania. Wyświetlany obiekt zadania potwierdza, że stan zadania to Zatrzymano.

Aby uzyskać więcej informacji na temat zdalnych zadań działających w tle, zobacz about_Remote_Jobs.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Do tego polecenia cmdlet można przekazać obiekt zadania.

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt zadania.

Program Windows PowerShell zawiera następujące aliasy dla Stop-Job:

• spjb