Wait-Process
等候進程停止,再接受更多輸入。
Syntax
Wait-Process
[-Name] <String[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[-Id] <Int32[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[[-Timeout] <Int32>]
-InputObject <Process[]>
[<CommonParameters>]
Description
此 Cmdlet 無法在 Linux 或 macOS 上運作。
Cmdlet Wait-Process
會等候一或多個執行中的進程在接受輸入之前停止。 在 PowerShell 控制台中,此 Cmdlet 會隱藏命令提示字元,直到行程停止為止。 您可以依行程名稱或行程識別碼 (PID) 指定行程,或將行程物件管線傳送至 Wait-Process
。
Wait-Process
僅適用於在本機計算機上執行的進程。
範例
範例 1:停止進程並等候
本範例會停止 記事本 進程,然後等候進程停止,再繼續進行下一個命令。
$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid
Cmdlet Get-Process
會取得 記事本 進程的進程標識符,並將它儲存在變數中$nid
。 Stop-Process
會停止儲存在中的 $nid
標識碼的進程。 Wait-Process
會等到 記事本進程停止為止。
範例 2:指定進程
此範例示範將進程指定為 Wait-Process
的三種不同方法。 第一個命令會取得 記事本 進程,並將它儲存在變數中$p
。 第二個命令使用 Id 參數、第三個命令使用 Name 參數,而第四個命令則使用 InputObject 參數。
$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p
這些命令的結果相同,而且可以交替使用。
範例 3:等候進程指定時間
在此範例中, Wait-Process
等候 30 秒讓 Outlook 和 Winword 進程停止。 如果未停止這兩個進程,Cmdlet 會顯示非終止錯誤和命令提示字元。
Wait-Process -Name outlook, winword -Timeout 30
參數
-Id
指定進程的進程識別碼。 若要指定多個識別碼,請使用逗號來分隔標識符。
若要尋找行程的 PID,請輸入 Get-Process
。
Type: | Int32[] |
Aliases: | PID, ProcessId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
藉由提交進程物件來指定進程。 輸入包含進程物件的變數,或輸入取得進程物件的命令或表達式,例如 Get-Process
Cmdlet。
Type: | Process[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定進程的進程名稱。 若要指定多個名稱,請使用逗號來分隔名稱。 不支援萬用字元。
Type: | String[] |
Aliases: | ProcessName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Timeout
指定此 Cmdlet 等候指定進程停止的最大時間,以秒為單位。 當此間隔到期時,命令會顯示非終止錯誤,其中會列出仍在執行的進程,並結束等候。 根據預設,沒有逾時。
Type: | Int32 |
Aliases: | TimeoutSec |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
您可以使用管線將進程物件傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Cmdlet 使用 System.Diagnostics.Process 類別的 WaitForExit 方法。
不同於
Start-Process -Wait
,Wait-Process
只會等候識別的進程。Start-Process -Wait
會等候進程樹狀結構(進程及其所有子系)在傳回控件之前結束。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應