共用方式為


Stop-Process

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

語法

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-ProcessStop-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。