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 Wait-Process 會等候一或多個執行中的進程在接受輸入之前停止。 在 PowerShell 主控台中,此 Cmdlet 會隱藏命令提示字元,直到進程停止為止。 您可以透過進程名稱或進程識別碼來指定進程, (PID) ,或使用管線將進程物件傳送至 Wait-Process

Wait-Process 僅適用于在本機電腦上執行的進程。

範例

範例 1︰停止處理程序並等候

PS C:\> $nid = (Get-Process notepad).id
PS C:\> Stop-Process -Id $nid
PS C:\> Wait-Process -Id $nid

此範例會停止「記事本」處理程序,然後等候該處理程序停止之後,才繼續進行下一個命令。

第一個命令會 Get-Process 使用 Cmdlet 來取得記事本程式的識別碼。 它會將識別碼儲存在 變數中 $nid

第二個命令會 Stop-Process 使用 Cmdlet 來停止儲存在 中的 $nid 識別碼的進程。

第三個命令會使用 Wait-Process 來等候記事本程式停止。 它會使用 的 Wait-ProcessId參數來識別進程。

範例 2︰指定處理程序

PS C:\> $p = Get-Process notepad
PS C:\> Wait-Process -Id $p.id
PS C:\> Wait-Process -Name "notepad"
PS C:\> Wait-Process -InputObject $p

這些命令會顯示三種不同的方法,可將進程指定為 Wait-Process 。 第一個命令會取得記事本程式,並將它儲存在 變數中 $p

第二個命令會使用 Id 參數、第三個命令會使用 Name 參數,而第四個命令會使用 InputObject 參數。

這些命令的結果皆相同,並且可交換使用。

範例 3︰等候處理程序一段指定的時間

PS C:\> Wait-Process -Name outlook, winword -Timeout 30

這個命令會等候 30 秒讓 Outlook 和 Winword 處理程序停止。 如果這兩個處理程序都沒有停止,則此 Cmdlet 會顯示一個非終止錯誤和命令提示字元。

參數

-Id

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

Type:Int32[]
Aliases:PID, ProcessId
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

藉由送出處理程序物件來指定處理程序。 輸入包含進程物件的變數,或輸入取得進程物件的命令或運算式,例如 Get-Process Cmdlet。

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

-Name

指定處理程序的處理程序名稱。 若要指定多個名稱,請使用逗號來分隔名稱。 不支援萬用字元。

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

-Timeout

指定此 Cmdlet 等候指定之處理程序停止的時間上限 (秒)。 當這個間隔時間過期時,此命令會顯示一個非終止錯誤,當中列出仍在執行的處理程序,然後結束等候。 預設是沒有逾時。

Type:Int32
Aliases:TimeoutSec
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

輸入

Process

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

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

  • 此 Cmdlet 會使用System.Diagnostics.Process類別的WaitForExit方法。

  • 不同于 Start-Process -WaitWait-Process 只會等候識別的進程。 Start-Process -Wait 會等候進程樹狀結構 (進程及其所有子系) 結束,然後再傳回控制項。