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

Stop-Job cmdlet 停止正在进行的 PowerShell 后台作业。 可以使用此 cmdlet 根据作业的名称、ID、实例 ID 或状态或将作业对象传递给 Stop-Job来停止所有作业或停止所选作业。

可以使用 Stop-Job 来停止后台作业，例如使用 Start-Job cmdlet 或任何 cmdlet 的 AsJob 参数启动的作业。 停止后台作业时，PowerShell 将完成该作业队列中挂起的所有任务，然后结束该作业。 提交此命令后，不会向队列添加新任务。

此 cmdlet 不会删除后台作业。 若要删除作业，请使用 Remove-Job cmdlet。

从 Windows PowerShell 3.0 开始，Stop-Job 还会停止自定义作业类型，例如 WorkflowJobs 和 ScheduledJobs实例。 若要使 Stop-Job 停止具有自定义作业类型的作业，请在运行 Stop-Job 命令之前将支持自定义作业类型的模块导入到会话中，方法是使用 Import-Module cmdlet 或通过使用或获取模块中的 cmdlet。 有关特定自定义作业类型的信息，请参阅自定义作业类型功能的文档。

$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 cmdlet 停止在远程计算机上运行的作业。

由于作业是使用 Invoke-Command cmdlet 远程运行 Start-Job 命令而启动的，因此作业对象存储在远程计算机上。 必须使用另一个 Invoke-Command 命令远程运行 Stop-Job 命令。 有关远程后台作业的详细信息，请参阅about_Remote_Jobs。

第一个命令在 Server01 计算机上创建 PowerShell 会话（PSSession），然后将会话对象存储在 $s 变量中。 该命令使用域管理员的凭据。

第二个命令使用 Invoke-Command cmdlet 在会话中运行 Start-Job 命令。 作业中的命令获取系统事件日志中的所有事件。 生成的作业对象存储在 $j 变量中。

第三个命令停止作业。 它使用 Invoke-Command cmdlet 在 Server01 上的 Stop-Job 中运行 命令。 由于作业对象存储在本地计算机上的 $j中，因此该命令使用 Using: 范围修饰符将 $j 标识为局部变量。 有关 Using: 范围修饰符的详细信息，请参阅 about_Remote_Variables。

命令完成后，作业将停止， 可供使用。

Stop-Job -Name "Job1"

此命令停止 Job1 后台作业。

Stop-Job -Id 1, 3, 4

此命令停止三个作业。 它通过 ID标识它们。

Get-Job | Stop-Job

此命令停止当前会话中的所有后台作业。

Stop-Job -State Blocked

此命令停止阻止的所有作业。

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

这些命令演示如何根据其 InstanceId停止作业。

第一个命令使用 Get-Job cmdlet 获取当前会话中的作业。 该命令使用管道运算符（|）将作业发送到 Format-Table 命令，该命令显示每个作业的指定属性的表。 该表包括每个作业 InstanceId。 它使用计算属性来显示作业状态。

第二个命令使用具有 Stop-Job 参数的 命令来停止所选作业。

$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 cmdlet 停止在远程计算机上运行的作业。

由于作业是使用 cmdlet Invoke-Command 参数启动的，因此即使作业在远程计算机上运行，Job 对象也位于本地计算机上。 因此，可以使用本地 Stop-Job 命令停止作业。

第一个命令使用 Invoke-Command cmdlet 在 Server01 计算机上启动后台作业。 该命令使用 AsJob 参数将远程命令作为后台作业运行。

此命令返回一个作业对象，该对象与 Start-Job cmdlet 返回的作业对象相同。 该命令将作业对象保存在 $j 变量中。

第二个命令使用管道运算符将 $j 变量中的作业发送到 Stop-Job。 该命令使用 PassThru 参数指示 Stop-Job 返回作业对象。 作业对象显示确认作业的状态已停止。

有关远程后台作业的详细信息，请参阅 about_Remote_Jobs。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

你可以通过管道将作业对象传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 将返回作业对象。

Windows PowerShell 为 Stop-Job提供以下别名：

• spjb