共用方式為

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

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

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

範例

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

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

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

範例 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：停止進程並偵測其已停止

PS C:\> calc
PS C:\> $p = Get-Process -Name "calc"
PS C:\> Stop-Process -InputObject $p
PS C:\> 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 C:\> 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 C:\> 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 C:\> Get-Process -Name "lsass" | Stop-Process -Force
[ADMIN]: PS C:\>

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

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

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

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

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

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

-Force

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

若要尋找進程的擁有者，請使用 Get-WmiObject 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, System.Diagnostics.Process

如果您 指定 passThru 參數，這個 Cmdlet 會傳回代表已停止進程的 System.Diagnostics.Process 物件。 否則，此 Cmdlet 不會產生任何輸出。

備註

  • 您也可以透過內建別名 終止 和 spps來參考 Stop-Process。 如需詳細資訊，請參閱about_Aliases。

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

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