Compartilhar via

Measure-Command

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

Default (Padrão) 

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.

Observação

Os blocos de script são executados Measure-Command executados no escopo atual, não por um escopo filho.

Exemplos

Exemplo 1: medir um comando

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

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 caminho para obter apenas arquivos .txt 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: Entrada de tubulação para Measure-Command

Os objetos que são canalizados para Measure-Command estão disponíveis para o bloco de script que é passado para o parâmetro expressão. O bloco de script é executado uma vez para cada objeto no pipeline.

# 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

Exemplo 5: Medindo a execução em um escopo filho

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.

Parâmetros

-Expression

Especifica a expressão que está sendo cronometrada. Coloque a expressão entre chaves ({}).

Propriedades do parâmetro

Tipo:ScriptBlock
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Objetos associados ao parâmetro InputObject são entrada opcional para o bloco de script passado para o parâmetro expressão. Dentro do bloco de script, $_ pode ser usado para referenciar o objeto atual no pipeline.

Propriedades do parâmetro

Tipo:PSObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSObject

Você pode redirecionar um objeto para este cmdlet.

Saídas

TimeSpan

Esse cmdlet retorna um objeto de intervalo de tempo que representa o resultado.