Write-Progress

Write-Progress [-Activity] <string> [-Status] <string> [[-Id] <int>] [-Completed] [-CurrentOperation <string>] [-ParentId <int>] [-PercentComplete <int>] [-SecondsRemaining <int>] [-SourceId <int>] [<CommonParameters>]

C:\PS>for ($i = 1; $i -lt 101; $i++ ) 
{for ($j=0;$j -lt 10000;$j++) {} write-progress -activity "Search in Progress" -status "% Complete:" -percentcomplete $i;}

説明
-----------
このコマンドは、入れ子になった 2 つの For ループの進行状況を表示します。最初のループは 100 までカウントされます。そのループのインクリメントごとに、2 番目のループは 10000 までカウントされます。
Write-Progress コマンドには、ステータス バーの見出し ("activity")、ステータス行、タスクの相対的完全性を示す変数 $i (For ループのカウンター) が含まれています。

C:\PS>for($i = 1; $i -lt 101; $i++ ) {write-progress -activity Updating -status progress-> -percentcomplete $i -currentOperation OuterLoop} for($i = 1; $i -lt 101; $i++ ) {write-progress -activity Updating -status progress -percentcomplete $i -id  1 -currentOperation InnerLoop}

Updating 
   progress ->
   [oooooooooooooooooo                                                   ]

   OutsideLoop

Updating
  progress  
  [oooooooooooooooooo                                                    ]

  InnerLoop

説明
-----------
この例は、入れ子になった 2 つの For ループの進行状況を表示します。それぞれの For ループは別個の進行状況バーで表されます。

2 番目の進行状況バーに対する Write-Progress コマンドには、最初の進行状況バーと区別する Id パラメーターが含まれています。Id パラメーターを指定しないと、進行状況バーは上下に並んで表示されるのではなく、互いに重なって表示されます。

C:\PS>$events = get-eventlog -logname system

C:\PS> $events | foreach-object -begin {clear-host;$i=0;$out=""} `
-process {if($_.message -like "*bios*") {$out=$out + $_.Message};
$i = $i+1;`
write-progress -activity "Searching Events" `
-status "Progress:" -percentcomplete ($i/$events.count*100)} `
-end {$out}

説明
-----------
このコマンドは、システム イベント ログの中から "bios" という文字列を検索する場合のコマンドの進行状況を表示します。

コマンドの最初の行で、Get-EventLog コマンドレットはシステム ログ内のイベントを取得し、そのイベントを $events 変数に保存します。

2 行目で、イベントはパイプを使用して ForEach-Object コマンドレットに渡されます。処理が開始される前に、Clear-Host コマンドレットを使用して画面がクリアされ、$i カウンター変数に 0 が設定され、$out 出力変数に空の文字列が設定されます。


ForEach-Object コマンドレットの Process スクリプト ブロックである 3 行目では、各入力オブジェクトのメッセージ プロパティに "bios" が含まれているかどうかを検索します。文字列が見つかった場合は、そのメッセージが $out に追加されます。

4 行目では、$i カウンター変数がインクリメントされ、イベントを 1 つ調べたことが記録されます。

5 行目は、進行状況バーの見出しの 1 行目と 2 行目になる Activity テキスト フィールドと Status テキスト フィールドの値を指定して Write-Progress コマンドレットを使用します。PercentComplete パラメーターの値は、処理したイベントの数 ($i) を取得したイベントの総数 ($events.count) で除算した結果に 100 を乗算して計算されています。

最後の行で、ForEach-Object コマンドレットの End パラメーターを使用して、$out 変数に格納されているメッセージを表示します。