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

描述
-----------
在這個範例中，會示範如何依據執行工作的個體識別碼來移除工作。

第一個會命令會使用 Start-Job Cmdlet 來啟動背景工作。這個命令會將產生的工作物件儲存在 $j 變數中。

第二個命令會使用管線運算子 (|)，將 $j 中的工作物件傳送到 Format-List 命令。Format-List 命令會使用值為 * (所有) 的 Property 參數，在清單中顯示工作物件的所有屬性。

工作物件顯示會列出 ID 和 InstanceID 屬性的值，以及物件的其他屬性。

第三個命令會使用 Remove-Job 命令，從目前的工作階段移除工作。若要產生此命令，您可以從物件顯示複製及貼上 InstanceID 值。

若要在 Windows PowerShell 主控台中複製值，請使用滑鼠選取值，然後再按 Enter 進行複製。若要貼上值，請按一下滑鼠右鍵。