共用方式為

Wait-Process

  • 參考
模組:
Microsoft.PowerShell.Management

等候進程停止，再接受更多輸入。

語法

Wait-Process
    [-Name] <String[]>
    [[-Timeout] <Int32>]
    [<CommonParameters>]
Wait-Process
    [-Id] <Int32[]>
    [[-Timeout] <Int32>]
    [<CommonParameters>]
Wait-Process
    [[-Timeout] <Int32>]
    -InputObject <Process[]>
    [<CommonParameters>]

Description

Wait-Process Cmdlet 會等候一或多個執行中的進程在接受輸入之前停止。 在 Windows 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-Process 的 識別碼 參數來識別進程。

範例 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。

類型:Int32[]
別名:PID, ProcessId
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

藉由提交進程物件來指定進程。 輸入包含進程物件的變數，或輸入取得進程物件的命令或表達式，例如 Get-Process Cmdlet。

類型:Process[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定進程的進程名稱。 若要指定多個名稱，請使用逗號來分隔名稱。 不支援通配符。

類型:String[]
別名:ProcessName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Timeout

指定此 Cmdlet 等候指定進程停止的最大時間，以秒為單位。 當此間隔到期時，命令會顯示非終止錯誤，其中會列出仍在執行的進程，並結束等候。 根據預設，沒有逾時。

類型:Int32
別名:TimeoutSec
Position:1
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Process

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

輸出

None

此 Cmdlet 不會產生任何輸出。

備註

  • 此 Cmdlet 使用 System.Diagnostics.Process 類別的 WaitForExit 方法。 如需此方法的詳細資訊，請參閱 Microsoft .NET Framework SDK。