Udostępnij za pośrednictwem

Measure-Command

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Mierzy czas potrzebny na uruchomienie bloków skryptów i poleceń cmdlet.

Składnia

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

Opis

Polecenie cmdlet Measure-Command uruchamia blok skryptu lub polecenie cmdlet wewnętrznie, czas wykonywania operacji i zwraca czas wykonywania.

Nuta

Bloki skryptu uruchamiane przez Measure-Command są uruchamiane w bieżącym zakresie, a nie w zakresie podrzędnym.

Przykłady

Przykład 1: Mierzenie polecenia

W tym przykładzie mierzy czas potrzebny na uruchomienie polecenia Get-EventLog, które pobiera zdarzenia w dzienniku zdarzeń programu Windows PowerShell.

Measure-Command { Get-EventLog "windows powershell" }

Przykład 2. Porównanie dwóch danych wyjściowych z Measure-Command

Pierwsze polecenie mierzy czas potrzebny na przetworzenie cyklicznego polecenia , które używa parametru ścieżka , aby pobrać tylko pliki w katalogu i jego podkatalogach.

Drugie polecenie mierzy czas potrzebny na przetworzenie cyklicznego polecenia Get-ChildItem, które używa parametru specyficznego dla dostawcy.

Te polecenia pokazują wartość użycia filtru specyficznego dla dostawcy w poleceniach programu 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

Przykład 3. Potokowanie danych wejściowych do Measure-Command

Obiekty przesyłane potokiem do Measure-Command są dostępne dla bloku skryptu przekazywanego do parametru Expression. Blok skryptu jest wykonywany raz dla każdego obiektu w potoku.

# 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

Przykład 4. Wyświetlanie danych wyjściowych mierzonego polecenia

Aby wyświetlić dane wyjściowe wyrażenia w Measure-Command, możesz użyć potoku do 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

Przykład 5. Mierzenie wykonywania w zakresie podrzędnym

Measure-Command uruchamia blok skryptu w bieżącym zakresie, więc blok skryptu może modyfikować wartości w bieżącym zakresie. Aby uniknąć zmian w bieżącym zakresie, należy opakować blok skryptu w nawiasach klamrowych ({}) i użyć operatora wywołania (&), aby wykonać blok w zakresie podrzędnym.

$foo = 'Value 1'
$null = Measure-Command { $foo = 'Value 2' }
$foo
$null = Measure-Command { & { $foo = 'Value 3' } }
$foo

Value 2
Value 2

Aby uzyskać więcej informacji na temat operatora wywołania, zobacz about_Operators.

Parametry

-Expression

Określa wyrażenie, które jest wykonywane. Ujmij wyrażenie w nawiasach klamrowych ({}).

Typ:ScriptBlock
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekty powiązane z parametrem InputObject są opcjonalnymi danymi wejściowymi dla bloku skryptu przekazanego do parametru expression . Wewnątrz bloku skryptu można użyć $_ do odwołowania się do bieżącego obiektu w potoku.

Typ:PSObject
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSObject

Obiekt można przekazać potokiem do Measure-Command.

Dane wyjściowe

TimeSpan

Measure-Command zwraca obiekt przedziału czasu reprezentujący wynik.