Stop-Process

模組:

Microsoft.PowerShell.Management

停止一或多個執行中的處理程序。

Syntax

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 參數來指定進程，而這些進程全都有相同的名稱。 如果您要使用 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：停止進程並偵測到它已停止

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 會提示您確認。

第二個命令會指定 Force 來隱藏提示。 因此，會在不需要確認的情況下停止處理程序。

參數

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

在沒有提示確認的情況下停止指定的處理程序。 根據預設， Stop-Process 會在停止目前使用者未擁有的任何進程之前，提示確認。

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Int32[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

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

Type:	Process[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Aliases:	ProcessName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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。

相關連結

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