Wait-Process
プロセスが停止するまで、次の入力を受け取るのを待ちます。
構文
Wait-Process
[-Name] <String[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[-Id] <Int32[]>
[[-Timeout] <Int32>]
[<CommonParameters>]
Wait-Process
[[-Timeout] <Int32>]
-InputObject <Process[]>
[<CommonParameters>]
説明
このコマンドレットは、Linux または macOS では機能しません。
コマンドレットは Wait-Process
、入力を受け入れる前に、実行中の 1 つ以上のプロセスが停止するのを待機します。 PowerShell コンソールでは、このコマンドレットは、プロセスが停止するまでコマンド プロンプトを抑制します。 プロセス名またはプロセス ID (PID) でプロセスを指定するか、プロセス オブジェクトを に Wait-Process
パイプできます。
Wait-Process
は、ローカル コンピューターで実行されているプロセスでのみ機能します。
例
例 1: プロセスを停止して待機する
次の使用例は 、メモ帳 プロセスを停止し、プロセスが停止するまで待ってから、次のコマンドに進みます。
$nid = (Get-Process notepad).id
Stop-Process -Id $nid
Wait-Process -Id $nid
コマンドレットはGet-Process
、メモ帳プロセスのプロセス ID を取得し、変数に$nid
格納します。 Stop-Process
は、 に格納されている ID を使用してプロセスを $nid
停止します。 Wait-Process
は、メモ帳プロセスが停止するまで待機します。
例 2: プロセスの指定
この例では、 にプロセスを指定する 3 つの異なる方法を Wait-Process
示します。 最初のコマンドはメモ帳プロセスを取得し、 変数に $p
格納します。 2 番目のコマンドは Id パラメーターを使用し、3 番目のコマンドは Name パラメーターを使用し、4 番目のコマンドでは InputObject パラメーターを使用します。
$p = Get-Process notepad
Wait-Process -Id $p.id
Wait-Process -Name "notepad"
Wait-Process -InputObject $p
これらのコマンドの結果はすべて同じであり、置き換えて使用することもできます。
例 3: 指定した時間プロセスを待機する
この例では、 Wait-Process
Outlook プロセスと Winword プロセスが停止するまで 30 秒待ちます。 プロセスがいずれも停止しない場合、コマンドレットによって未終了エラーが表示され、コマンド プロンプトが表示されます。
Wait-Process -Name outlook, winword -Timeout 30
パラメーター
-Id
プロセスのプロセス ID を指定します。 複数の ID を指定するには、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
入力します。
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
指定したプロセスが停止するまでこのコマンドレットが待機する最大時間 (秒単位) を指定します。 この時間が経過すると、まだ実行中のプロセスの一覧を示す未終了エラーが表示され、待機動作が終了します。 既定では、タイムアウトはありません。
Type: | Int32 |
Aliases: | TimeoutSec |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
このコマンドレットにプロセス オブジェクトをパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
このコマンドレットでは、System.Diagnostics.Process クラスの WaitForExit メソッドを使用します。
とは異なり
Start-Process -Wait
、Wait-Process
は識別されたプロセスのみを待機します。Start-Process -Wait
は、制御を返す前に、プロセス ツリー (プロセスとそのすべての子孫) が終了するまで待機します。