Measure-Command
Mede o tempo necessário para executar blocos de script e cmdlets.
Measure-Command
[-InputObject <PSObject>]
[-Expression] <ScriptBlock>
[<CommonParameters>]
O cmdlet Measure-Command
executa um bloco de script ou cmdlet internamente, cronometra a execução da operação e retorna o tempo de execução.
Observação
Os blocos de script são executados Measure-Command
executados no escopo atual, não por um escopo filho.
Este exemplo mede o tempo necessário para executar um comando Get-EventLog
que obtém os eventos no log de eventos do Windows PowerShell.
Measure-Command { Get-EventLog "windows powershell" }
O primeiro comando mede o tempo necessário para processar um comando
O segundo comando mede o tempo necessário para processar um comando Get-ChildItem
recursivo que usa o parâmetro "específico do provedor".
Esses comandos mostram o valor de usar um filtro específico do provedor nos comandos do PowerShell.
Measure-Command { Get-ChildItem -Path C:\Windows\*.txt -Recurse }
Days : 0
Hours : 0
Minutes : 0
Seconds : 8
Milliseconds : 618
Ticks : 86182763
TotalDays : 9.9748568287037E-05
TotalHours : 0.00239396563888889
TotalMinutes : 0.143637938333333
TotalSeconds : 8.6182763
TotalMilliseconds : 8618.2763
Measure-Command {Get-ChildItem C:\Windows -Filter "*.txt" -Recurse}
Days : 0
Hours : 0
Minutes : 0
Seconds : 1
Milliseconds : 140
Ticks : 11409189
TotalDays : 1.32050798611111E-05
TotalHours : 0.000316921916666667
TotalMinutes : 0.019015315
TotalSeconds : 1.1409189
TotalMilliseconds : 1140.9189
Os objetos que são canalizados para
# Perform a simple operation to demonstrate the InputObject parameter
# Note that no output is displayed.
10, 20, 50 | Measure-Command -Expression { for ($i=0; $i -lt $_; $i++) {$i} }
Days : 0
Hours : 0
Minutes : 0
Seconds : 0
Milliseconds : 12
Ticks : 122672
TotalDays : 1.41981481481481E-07
TotalHours : 3.40755555555556E-06
TotalMinutes : 0.000204453333333333
TotalSeconds : 0.0122672
TotalMilliseconds : 12.2672
Para exibir a saída da expressão no Measure-Command
você pode usar um pipe para Out-Default
.
# Perform the same operation as above adding Out-Default to every execution.
# This will show that the ScriptBlock is in fact executing for every item.
10, 20, 50 | Measure-Command -Expression {for ($i=0; $i -lt $_; $i++) {$i}; "$($_)" | Out-Default }
10
20
50
Days : 0
Hours : 0
Minutes : 0
Seconds : 0
Milliseconds : 11
Ticks : 113745
TotalDays : 1.31649305555556E-07
TotalHours : 3.15958333333333E-06
TotalMinutes : 0.000189575
TotalSeconds : 0.0113745
TotalMilliseconds : 11.3745
Measure-Command
executa o bloco de script no escopo atual, portanto, o bloco de script pode modificar valores no escopo atual. Para evitar alterações no escopo atual, você deve encapsular o bloco de script em chaves ({}
) e usar o operador de invocação (&
) para executar o bloco em um escopo filho.
$foo = 'Value 1'
$null = Measure-Command { $foo = 'Value 2' }
$foo
$null = Measure-Command { & { $foo = 'Value 3' } }
$foo
Value 2
Value 2
Para obter mais informações sobre o operador de invocação, consulte about_Operators.
Especifica a expressão que está sendo cronometrada. Coloque a expressão entre chaves ({}
).
Tipo: | ScriptBlock |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Objetos associados ao parâmetro InputObject $_
pode ser usado para referenciar o objeto atual no pipeline.
Tipo: | PSObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Você pode canalizar um objeto para Measure-Command
.
Measure-Command
retorna um objeto de intervalo de tempo que representa o resultado.