Stop-Job

Синтаксис

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

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

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

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

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

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

Описание

Командлет Stop-Job останавливает фоновые задания PowerShell, которые выполняются. Этот командлет можно использовать для остановки всех заданий или остановки выбранных заданий на основе их имени, идентификатора, идентификатора экземпляра или состояния или передачи объекта Stop-Jobзадания в .

Можно использовать Stop-Job для остановки фоновых заданий, таких как запущенные с помощью Start-Job командлета или параметра AsJob любого командлета. При остановке фонового задания PowerShell завершает все задачи, ожидающие в этой очереди заданий, а затем завершает задание. Новые задания не добавляются в очередь после отправки этой команды.

Этот командлет не удаляет фоновые задания. Чтобы удалить задание, используйте Remove-Job командлет.

Начиная с Windows PowerShell 3.0, Stop-Job также останавливает пользовательские типы заданий, такие как Рабочие задания и экземпляры ScheduledJobs. Чтобы включить Stop-Job остановку задания с пользовательским типом задания, импортируйте модуль, поддерживающий пользовательский тип задания, перед выполнением Stop-Job команды с помощью командлета или с помощью Import-Module командлета или получения командлета в модуле. Дополнительные сведения о определенных пользовательских типах заданий см. в разделе документации о данной функции.

Примеры

Пример 1. Остановка задания на удаленном компьютере с помощью Invoke-Command

$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 }

В этом примере показано, как использовать Stop-Job командлет для остановки задания, выполняемого на удаленном компьютере.

Так как задание было запущено с Invoke-Command командлетом для удаленного Start-Job выполнения команды, объект задания хранится на удаленном компьютере. Для удаленного выполнения команды необходимо использовать другую Invoke-Command Stop-Job команду. Дополнительные сведения об удаленных фоновых заданиях см. в разделе about_Remote_Jobs.

Первая команда создает сеанс PowerShell (PSSession) на компьютере Server01, а затем сохраняет объект сеанса в переменной $s . Команда использует учетные данные администратора домена.

Вторая команда использует Invoke-Command командлет для выполнения Start-Job команды в сеансе. Команда в задании получает все события в системном журнале событий. Результирующий объект задания хранится в переменной $j .

Третья команда останавливает задание. Он использует Invoke-Command командлет для выполнения Stop-Job команды в PSSession на Server01. Так как объекты задания хранятся в $j, которая является переменной на локальном компьютере, команда использует модификатор области Using для идентификации $j как локальной переменной. Дополнительные сведения об модификаторе области using см. в about_Remote_Variables.

По завершении команды задание остановлено, а служба PSSession $s доступна для использования.

Пример 2. Остановка фонового задания

Stop-Job -Name "Job1"

Эта команда останавливает фоновое Job1 задание.

Пример 3. Остановка нескольких фоновых заданий

Stop-Job -Id 1, 3, 4

Эта команда останавливает три задания. Он определяет их идентификаторами.

Пример 4. Остановка всех фоновых заданий

Get-Job | Stop-Job

Эта команда останавливает все фоновые задания в текущем сеансе.

Пример 5. Остановка всех заблокированных фоновых заданий

Stop-Job -State Blocked

Эта команда останавливает все задания, которые заблокированы.

Пример 6. Остановка задания по идентификатору экземпляра

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

Эти команды показывают, как остановить задание на основе идентификатора экземпляра.

Первая команда использует Get-Job командлет для получения заданий в текущем сеансе. Команда использует оператор конвейера (|) для отправки заданий Format-Table в команду, которая отображает таблицу указанных свойств каждого задания. Таблица содержит Идентификатор экземпляра каждого задания. Для отображения состояния задания используется вычисляемое свойство.

Вторая команда использует команду с параметром Stop-Job InstanceID , чтобы остановить выбранное задание.

Пример 7. Остановка задания на удаленном компьютере

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

В этом примере показано, как использовать Stop-Job командлет для остановки задания, выполняемого на удаленном компьютере.

Так как задание было запущено с параметром Invoke-Command AsJob командлета, объект Job находится на локальном компьютере, даже если задание выполняется на удаленном компьютере. Поэтому для остановки задания можно использовать локальную Stop-Job команду.

Первая команда использует Invoke-Command командлет для запуска фонового задания на компьютере Server01. Команда использует параметр AsJob для выполнения удаленной команды в качестве фонового задания.

Эта команда возвращает объект задания, который является тем же объектом задания, что Start-Job и командлет. Команда сохраняет объект задания в переменной $j .

Вторая команда использует оператор конвейера для отправки $j задания в переменную Stop-Job. Команда использует параметр PassThru для прямого Stop-Job возврата объекта задания. Отображение объекта задания подтверждает, что состояние задания остановлено.

Дополнительные сведения о удаленных фоновых заданиях см. в about_Remote_Jobs.

Параметры

-Confirm

-Filter

-Id

-InstanceId

-Job

-Name

-PassThru

-State

-WhatIf

Входные данные

System.Management.Automation.RemotingJob

Объект задания можно передать в этот командлет.

Выходные данные

None

По умолчанию этот командлет не возвращает выходные данные.

System.Management.Automation.PSRemotingJob

При использовании параметра PassThru этот командлет возвращает объект задания.

Примечания

PowerShell включает следующие псевдонимы для Stop-Job:

• Все платформы:
  • spjb

Связанные ссылки

• Get-Job.
• Invoke-Command
• Receive-Job.
• Remove-Job
• Start-Job
• Wait-Job
• about_Job_Details
• about_Remote_Jobs
• about_Remote_Variables
• about_Jobs
• about_Scopes