Freigeben über


Measure-Command

Misst die Zeit, die zum Ausführen von Skriptblöcken und Cmdlets benötigt wird.

Syntax

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

Beschreibung

Mit dem Cmdlet "Measure-Command" wird ein Skriptblock oder Cmdlet intern ausgeführt, die Ausführungsdauer des Vorgangs erfasst und zurückgegeben.

Parameter

-Expression <scriptblock>

Gibt den Ausdruck an, dessen Ausführungsdauer erfasst wird. Schließen Sie den Ausdruck in geschweifte Klammern ({}) ein. Der Parametername ("Expression") ist optional.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-InputObject <psobject>

Gibt Objekte an, die die zu messenden Ausdrücke darstellen. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.Management.Automation.PSObject

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

Ausgaben

System.TimeSpan

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

Hinweise

Weitere Informationen erhalten Sie mit folgendem Befehl: "Get-Help Measure-Command -detailed". Technische Informationen erhalten Sie mit folgendem Befehl: "Get-Help Measure-Command -full".

Um für einen Parameter mehrere Werte anzugeben, trennen Sie diese durch Kommas. Beispiel: "<Parametername> <Wert1>, <Wert2>".

Beispiel 1

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

Beschreibung
-----------
Mit diesem Befehl wird gemessen, wie viel Zeit die Ausführung des Befehls "get-eventlog" beansprucht, mit dem die Ereignisse im Windows PowerShell-Ereignisprotokoll abgerufen werden.





Beispiel 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

Beschreibung
-----------
Mit diesen Befehlen wird veranschaulicht, warum sich die Verwendung eines anbieterspezifischen Filters in Windows PowerShell-Befehlen empfiehlt. Im ersten Befehl wird die Verarbeitungsdauer des rekursiven Befehls "Get-ChildItem" gemessen, in dem der Include-Parameter verwendet wird. Im zweiten Befehl wird die Verarbeitungsdauer des rekursiven Befehls "Get-ChildItem" gemessen, in dem der anbieterspezifische Filter-Parameter verwendet wird.





Siehe auch

Konzepte

Trace-Command
Invoke-Command