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;}

Descrição
-----------
Esse comando exibe o progresso de dois loops For aninhados. O primeiro loop conta até 100. Para cada incremento daquele loop, o segundo loop conta até 10.000.
O comando Write-Progress inclui um título da barra de status ("activity"), uma linha de status e a variável $i (o contador no loop For), que indica a conclusão relativa da tarefa.

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

Descrição
-----------
Esse exemplo exibe o progresso de dois loops For aninhados, cada um deles representado por uma barra de progresso.

O comando Write-Progress para a segunda barra de progresso inclui o parâmetro Id que o distingue da primeira barra de progresso. Sem o parâmetro Id, as barras de progresso seriam sobrepostas umas sobre as outras, em vez de serem exibidas uma abaixo da outra.

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}

Descrição
-----------
Esse comando exibe o progresso de um comando para localizar a cadeia de caracteres "bios" no log de eventos do sistema. 

Na primeira linha do comando, o cmdlet Get-EventLog obtém os eventos no log do sistema e os armazena na variável $events. 

Na segunda linha, os eventos são canalizados para o cmdlet ForEach-Object. Antes de iniciar o processamento, o cmdlet Clear-Host é usado para limpar a tela, a variável de contador $i é definida como zero e a variável de saída $out é definida como a cadeia de caracteres vazia. 


Na terceira linha, que é o bloco de scripts Process do cmdlet ForEach-Object, o cmdlet pesquisa "bios" na propriedade de mensagem de cada objeto de entrada. Se a cadeia de caracteres for localizada, a mensagem será adicionada a $out. 

Na quarta linha, a variável de contador $i é incrementada para registrar que outro evento foi examinado. 

A quinta linha usa o cmdlet Write-Progress com valores para os campos de texto Activity e Status que criam a primeira e a segunda linhas do título da barra de progresso, respectivamente. O valor do parâmetro PercentComplete é calculado dividindo o número de eventos processados ($i) pelo número total de eventos recuperados ($events.count) e multiplicando esse resultado por 100. 

Na última linha, o parâmetro End do cmdlet ForEach-Object é usado para exibir as mensagens que são armazenadas na variável $out.