Freigeben über

Measure-Command

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Misst die Ausführungszeit von Skriptblöcken und Cmdlets.

Syntax

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

Beschreibung

Das Measure-Command Cmdlet führt intern einen Skriptblock oder ein Cmdlet aus, malt die Ausführung des Vorgangs und gibt die Ausführungszeit zurück.

Hinweis

Skriptblöcke, die im aktuellen Bereich ausgeführt werden Measure-Command , nicht im untergeordneten Bereich.

Beispiele

Beispiel 1: Messen eines Befehls

Dieses Beispiel misst die Zeit, die zum Ausführen eines Get-EventLog Befehls benötigt wird, der die Ereignisse im Windows PowerShell Ereignisprotokoll abruft.

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

Beispiel 2: Vergleichen von zwei Ausgaben aus Measure-Command

Der erste Befehl misst die Zeit, die zum Verarbeiten eines rekursiven Get-ChildItem Befehls benötigt wird, der den Path-Parameter verwendet, um nur .txt Dateien im Verzeichnis und seinen C:\Windows Unterverzeichnissen abzurufen.

Der zweite Befehl misst die Zeit, die zum Verarbeiten eines rekursiven Get-ChildItem Befehls benötigt wird, der den anbieterspezifischen Parameter " verwendet.

Diese Befehle zeigen den Wert der Verwendung eines anbieterspezifischen Filters in PowerShell-Befehlen an.

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

Beispiel 3: Piping-Eingabe an Measure-Command

Objekte, an Measure-Command die eine Pipe übergeben wird, stehen für den Skriptblock zur Verfügung, der an den Expression-Parameter übergeben wird. Der Skriptblock wird für jedes Objekt in der Pipeline einmal ausgeführt.

# 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

Beispiel 4: Anzeigen der Ausgabe des gemessenen Befehls

Um die Ausgabe des Ausdrucks in Measure-Command anzuzeigen, können Sie eine Pipe zu Out-Defaultverwenden.

# 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

Beispiel 5: Messen der Ausführung in einem untergeordneten Bereich

Measure-Command führt den Skriptblock im aktuellen Bereich aus, damit der Skriptblock Werte im aktuellen Bereich ändern kann. Um Änderungen am aktuellen Bereich zu vermeiden, müssen Sie den Skriptblock in Klammern ({}) umschließen und den Aufrufoperator (&) verwenden, um den Block in einem untergeordneten Bereich auszuführen.

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

Value 2
Value 2

Weitere Informationen zum Aufrufoperator finden Sie unter about_Operators.

Parameter

-Expression

Gibt den Ausdruck an, dessen Ausführungsdauer gemessen wird. Schließen Sie den Ausdruck in Klammern ({}) ein.

Type:ScriptBlock
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Objekte, die an den InputObject-Parameter gebunden sind, sind optionale Eingaben für den Skriptblock, der an den Expression-Parameter übergeben wird. Innerhalb des Skriptblocks kann verwendet werden, $_ um auf das aktuelle Objekt in der Pipeline zu verweisen.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

PSObject

Sie können ein -Objekt an übergeben Measure-Command.

Ausgaben

TimeSpan

Measure-Command gibt ein Zeitspannenobjekt zurück, das das Ergebnis darstellt.