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>]

説明

このコマンドレットは、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: プロセスの指定

この例では、プロセス Wait-Processを指定する 3 つの異なる方法を示します。 最初のコマンドは、メモ帳 プロセスを取得し、変数に$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

入力

Process

このコマンドレットには、プロセス オブジェクトをパイプ処理できます。

出力

None

このコマンドレットは、出力を返しません。

メモ

  • このコマンドレットでは、System.Diagnostics.Process クラスの WaitForExit メソッドを使用します。

  • とは異なり Start-Process -Wait、 Wait-Process 特定されたプロセスのみを待機します。 Start-Process -Wait は、制御を返す前に、プロセス ツリー (プロセスとそのすべての子孫) が終了するのを待機します。