Compartilhar via

Measure-Command

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Mede o tempo necessário para executar blocos de script e cmdlets.

Sintaxe

Measure-Command
       [-InputObject <PSObject>]
       [-Expression] <ScriptBlock>
       [<CommonParameters>]

Description

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.

Exemplos

Exemplo 1: medir um comando

Esse comando 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" }

Exemplo 2: comparar duas saídas de Measure-Command

O primeiro comando mede o tempo necessário para processar um comando Get-ChildItem recursivo que usa o parâmetro -Path para obter apenas .txt arquivos no diretório C:\Windows e seus subdiretórios.

O segundo comando mede o tempo necessário para processar um comando Get-ChildItem recursivo que usa o parâmetro -Filter 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

Exemplo 3: usar o parâmetro InputObject de Measure-Command

Este exemplo mostra como usar o parâmetro InputObject de Measure-Command. O ScriptBlock passado para o parâmetro Expression é executado uma vez para cada objeto passado ou canalizado para o parâmetro InputObject.

Nota

Measure-Command ainda fornece uma medida da execução geral de ScriptBlock para cada elemento passado para o parâmetro InputObject.

# 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

Exemplo 4: Exibindo a saída do comando medido

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

Parâmetros

-Expression

Especifica a expressão que está sendo cronometrada. Coloque a expressão entre chaves ({}). O nome do parâmetro ("Expression") é opcional.

Tipo:ScriptBlock
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Objetos associados ao parâmetro InputObject são entrada opcional para o ScriptBlock passado para o parâmetro Expression. Dentro do ScriptBlock, $_ pode ser usado para fazer referência ao 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

Entradas

PSObject

Você pode canalizar um objeto para Measure-Command.

Saídas

TimeSpan

Measure-Command retorna um objeto de intervalo de tempo que representa o resultado.