Stop-Process

模組:

Microsoft.PowerShell.Management

停止一或多個執行中的進程。

語法

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

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

Stop-Process
    [-InputObject] <Process[]>
    [-PassThru]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdlet 會 Stop-Process 停止一或多個執行中的進程。 您可以依行程名稱或行程識別碼 （PID） 指定行程，或將行程物件傳遞至 Stop-Process。 Stop-Process 僅適用於在本機計算機上執行的進程。

在 Windows Vista 和更新版本的 Windows 作業系統上，若要停止目前使用者未擁有的進程，您必須使用 [以系統管理員身分執行] 選項啟動 PowerShell。 此外，除非您指定 Confirm 參數，否則系統不會提示您進行確認。

範例

範例 1：停止進程的所有實例

PS C:\> Stop-Process -Name "notepad"

此命令會停止電腦上 [記事本] 程式的所有實例。 記事本的每個實例都會在其自己的進程中執行。 它會使用 Name 參數來指定進程，所有這些進程都有相同的名稱。 如果您要使用 Id 參數來停止相同的進程，則必須列出記事本每個實例的進程標識碼。

範例 2：停止進程的特定實例

PS C:\> Stop-Process -Id 3952 -Confirm -PassThru

Confirm
Are you sure you want to perform this action?
Performing operation "Stop-Process" on Target "notepad (3952)".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):y
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
41       2      996       3212    31            3952 notepad

此命令會停止記事本程式的特定實例。 它會使用進程標識碼 3952 來識別進程。 Confirm 參數會指示 PowerShell 在停止程式之前提示您。 因為提示除了標識碼之外也包含進程名稱，因此這是最佳做法。 PassThru 參數會將進程對象傳遞至格式器以供顯示。 如果沒有此參數，命令之後 Stop-Process 就不會顯示任何內容。

範例 3：停止進程並偵測其已停止

calc
$p = Get-Process -Name "calc"
Stop-Process -InputObject $p
Get-Process | Where-Object {$_.HasExited}

這一系列的命令會啟動和停止 Calc 進程，然後偵測已停止的進程。

第一個命令會啟動計算機的實例。

第二個命令會使用 Get-Process 取得代表 Calc 進程的 對象，然後將它儲存在變數中 $p 。

第三個命令會 Calc 停止進程。 它會使用 InputObject 參數將 物件傳遞至 Stop-Process。

最後一個命令會取得計算機上執行但現在已停止的所有進程。 它會使用 Get-Process 來取得計算機上的所有進程。 管線運算符 （|） 會將結果傳遞至 Where-Object Cmdlet，其會選取 HasExited 屬性的值$True。 HasExited 只是進程物件的一個屬性。 若要尋找所有屬性，請輸入 Get-Process | Get-Member。

範例 4：停止目前使用者未擁有的進程

PS> Get-Process -Name "lsass" | Stop-Process

Stop-Process : Cannot stop process 'lsass (596)' because of the following error: Access is denied
At line:1 char:34
+ Get-Process -Name "lsass" | Stop-Process <<<<

[ADMIN]: PS> Get-Process -Name "lsass" | Stop-Process

Warning!
Are you sure you want to perform this action?
Performing operation 'Stop-Process' on Target 'lsass(596)'
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

[ADMIN]: PS> Get-Process -Name "lsass" | Stop-Process -Force
[ADMIN]: PS>

這些命令會顯示使用 Force 停止使用者未擁有的進程的效果。

第一個命令會使用 Get-Process 來取得 Lsass 進程。 管線運算符會將進程傳送至 Stop-Process 以停止它。 如範例輸出所示，第一個命令失敗並出現拒絕存取訊息，因為此程式只能由計算機上的 Administrator 群組成員停止。

使用 [以系統管理員身分執行] 選項開啟 PowerShell 時，會重複命令，PowerShell 會提示您進行確認。

第二個命令會 指定 Force 來隱藏提示。 如此一來，進程就會停止，而不需要確認。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

停止指定的進程，而不提示確認。 根據預設， Stop-Process 會先提示確認，再停止目前使用者未擁有的任何進程。

若要尋找進程的擁有者，請使用 Get-CimInstance Cmdlet 取得 代表進程的Win32_Process 對象，然後使用 物件的 GetOwner 方法。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要停止之進程的進程識別碼。 若要指定多個識別碼，請使用逗號來分隔標識符。 若要尋找行程的 PID，請輸入 Get-Process。

類型:	Int32[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-InputObject

指定要停止的進程物件。 輸入包含 物件的變數，或輸入取得物件的命令或表達式。

類型:	Process[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

指定要停止之進程的進程名稱。 您可以輸入多個進程名稱，並以逗號分隔，或使用通配符。

類型:	String[]
別名:	ProcessName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	True

-PassThru

傳回代表進程的物件。 根據預設，此 Cmdlet 不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Process

您可以使用管線將進程物件傳送至此 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

Process

當您使用 PassThru 參數時，這個 Cmdlet 會 傳回代表已停止進程的 Process 物件。

備註

PowerShell 包含下列的 Stop-Process別名：

• 所有平臺：
  • spps
• Windows：
  • kill

您也可以在 Windows PowerShell 中使用 Windows Management Instrumentation （WMI） Win32_Process 物件的屬性和方法。 如需詳細資訊，請參閱 Get-CimInstance 和 WMI SDK。

• 停止進程時，請注意停止進程可以停止相依於進程的進程和服務。 在極端情況下，停止進程可以停止 Windows。

相關連結

• Debug-Process
• Get-Process
• Start-Process
• Stop-Process
• Wait-Process