Remove-Job

Remove-Job [-Id] <Int32[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Job [-Command <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Job [[-InstanceId] <Guid[]>] [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Job [-Job] <Job[]> [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Job [[-Name] <string[]>] [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-Job [-State {<NotStarted> | <Running> | <Completed> | <Failed> | <Stopped> | <Blocked>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>$batch = get-job -name BatchJob

C:\PS> $batch | remove-job

说明
-----------
这些命令将名为 BatchJob 的后台作业从当前会话中删除。第一个命令使用 Get-Job cmdlet 来获取代表作业的对象，然后将该作业保存在 $batch 变量中。第二个命令使用管道运算符 (|) 将作业发送到 Remove-Job cmdlet。

此命令等效于使用 Remove-Job 的 Job 参数，例如“remove-job -job $batch”。

C:\PS>get-job | remove-job

说明
-----------
此命令删除当前会话中的所有作业。

C:\PS>remove-job -state NotStarted

说明
-----------
此命令将所有尚未启动的作业从当前会话中删除。

C:\PS>remove-job -name *batch -force

说明
-----------
此命令将具有以“batch”结尾的友好名称的所有作业从当前会话中删除，包括正在运行的作业。

此命令使用 Remove-Job 的 Name 参数来指定作业名称模式，并使用 Force 参数来确保所有作业都被删除（甚至包括正在进行中的作业）。

C:\PS>$j = invoke-command -computername Server01 -scriptblock {get-process} -asJob

C:\PS> $j | remove-job

说明
-----------
此示例说明如何使用 Remove-Job cmdlet 来删除通过使用 Invoke-Command cmdlet 的 AsJob 参数在远程计算机上启动的作业。

第一个命令使用 Invoke-Command cmdlet 在 Server01 计算机上运行作业。该命令使用 AsJob 参数将命令作为后台作业运行，并将生成的作业对象保存在 $j 变量中。

由于该命令使用了 AsJob 参数，因此即使作业在远程计算机上运行，作业对象也在本地计算机上创建。因此，可以使用本地命令来管理作业。

第二个命令使用 Remove-Job cmdlet 来删除作业。该命令使用管道运算符 (|) 将 $j 中的作业发送到 Remove-Job。请注意此命令是本地命令。无需使用远程命令来删除通过使用 AsJob 参数启动的作业。

C:\PS>$s = new-pssession -computername Server01

C:\PS> invoke-command -session $s -scriptblock {start-job -scriptblock {get-process} -name MyJob}

C:\PS> invoke-command -session $s -scriptblock {remove-job -name MyJob}

说明
-----------
此示例说明如何删除通过使用 Invoke-Command 运行 Start-Job 命令启动的作业。在本例中，作业对象在远程计算机上创建，您使用远程命令来管理作业。

第一个命令使用 New-PSSession cmdlet 来创建与 Server01 计算机的 PSSession（持续性连接）。远程运行 Start-Job 命令时需要持续性连接。此命令将 PSSession 保存在 $s 变量中。

第二个命令使用 Invoke-Command cmdlet 在 $s 中的 PSSession 中运行 Start-Job 命令。作业运行 Get-Process 命令。它使用 Start-Job 的 Name 参数为作业指定一个友好名称。

第三个命令使用 Invoke-Command cmdlet 在 $s 中的 PSSession 中运行 Remove-Job 命令。该命令使用 Remove-Job 的 Name 参数来指定要删除的作业。

C:\PS>$j = start-job -script {get-process powershell}

C:\PS> $j | format-list -property *

C:\PS> remove-job -instanceID dce2ee73-f8c9-483e-bdd7-a549d8687eed

C:\PS> $j = start-job -script {get-process powershell}

C:\PS> $j | format-list -property *

HasMoreData   : False
StatusMessage :
Location      : localhost
Command       : get-process powershell
JobStateInfo  : Failed
Finished      : System.Threading.ManualResetEvent
InstanceId    : dce2ee73-f8c9-483e-bdd7-a549d8687eed
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

C:\PS> remove-job -instanceID dce2ee73-f8c9-483e-bdd7-a549d8687eed

说明
-----------
此示例说明如何根据作业的实例 ID 来删除作业。

第一个命令使用 Start-Job cmdlet 来启动后台作业。此命令将生成的作业对象保存在 $j 变量中。

第二个命令使用管道运算符 (|) 将 $j 中的作业对象发送到 Format-List 命令。Format-List 命令使用值为 *（全部）的 Property 参数在列表中显示作业对象的所有属性。

作业对象显示 ID 和 InstanceID 属性的值，以及对象的其他属性的值。

第三个命令使用 Remove-Job 命令将作业从当前会话中删除。要生成命令，可从显示的对象中复制并粘贴 InstanceID 值。

若要在 Windows PowerShell 控制台中复制某个值，请使用鼠标选中该值，然后按 Enter 复制它。若要粘贴值，请右键单击。