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.