Compartilhar via


Measure-Command

Mede o tempo para execução dos blocos de script e cmdlets.

Sintaxe

Measure-Command [-Expression] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]

Descrição

O cmdlet Measure-Command executa um bloco de script ou cmdlet internamente, calcula a duração da execução da operação e retorna o tempo de execução.

Parâmetros

-Expression <scriptblock>

Especifica a expressão que está sendo calculada em relação ao tempo de duração. Coloque a expressão entre parênteses e colchetes ({}). O nome do parâmetro ("Expression") é opcional.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-InputObject <psobject>

Especifica os objetos que representam as expressões a serem medidas. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

Você pode canalizar um objeto para Measure-Command.

Saídas

System.TimeSpan

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

Observações

Para obter mais informações, digite "Get-Help Measure-Command -detailed". Para obter informações técnicas, digite "Get-Help Measure-Command -full".

Quando estiver especificando diversos valores para um parâmetro, utilize vírgulas para separá-los. Por exemplo, "<nome-do-parâmetro><valor1>, <valor2>".

Exemplo 1

C:\PS>Measure-Command { get-eventlog "windows powershell" }

Descrição
-----------
Esse comando mede o tempo para execução de um comando "get-eventlog" que obtém os eventos no log de eventos do Windows PowerShell.





Exemplo 2

C:\PS>measure-command {get-childitem c:\windows -include *.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

C:\PS>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

Descrição
-----------
Estes comandos mostram o valor do uso de um filtro específico do provedor nos comandos do Windows PowerShell. O primeiro comando mede o tempo do processamento de um comando Get-ChildItem recursivo que utiliza o parâmetro Include. O segundo comando mede o tempo do processamento de um comando Get-ChildItem recursivo que utiliza o parâmetro Filter específico do provedor.





Consulte também

Conceitos

Trace-Command
Invoke-Command