Wait-Process

  • 參考
模組:
Microsoft.PowerShell.Management

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

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-Process Id參數來識別進程。

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

輸入

Process

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

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

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

  • 不同於 Start-Process -Wait， Wait-Process 只會等候識別的進程。 Start-Process -Wait 會等候進程樹狀結構（進程及其所有子系）在傳回控件之前結束。