Measure-Command

Mäter den tid det tar att köra skriptblock och cmdletar.

Syntax

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

Description

Cmdleten Measure-Command kör ett skriptblock eller en cmdlet internt, gånger körningen av åtgärden och returnerar körningstiden.

Kommentar

Skriptblock som körs genom Measure-Command körning i det aktuella omfånget, inte ett underordnat omfång.

Exempel

Exempel 1: Mät ett kommando

Det här exemplet mäter den tid det tar att köra ett Get-EventLog kommando som hämtar händelserna i Windows PowerShell-händelseloggen.

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

Exempel 2: Jämför två utdata från Measure-Command

Det första kommandot mäter den tid det tar att bearbeta ett rekursivt Get-ChildItem kommando som använder parametern Sökväg för att endast .txt hämta filer i C:\Windows katalogen och dess underkataloger.

Det andra kommandot mäter hur lång tid det tar att bearbeta ett rekursivt Get-ChildItem kommando som använder den providerspecifika filterparametern .

Dessa kommandon visar värdet för att använda ett providerspecifikt filter i PowerShell-kommandon.

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

Exempel 3: Piping-indata till Measure-Command

Objekt som skickas till Measure-Command är tillgängliga för skriptblocket som skickas till parametern Uttryck . Skriptblocket körs en gång för varje objekt i pipelinen.

# 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

Exempel 4: Visa utdata från uppmätt kommando

Om du vill visa utdata för uttrycket i Measure-Command kan du använda en pipe till 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

Exempel 5: Mäta körning i ett underordnat omfång

Measure-Command kör skriptblocket i det aktuella omfånget, så att skriptblocket kan ändra värden i det aktuella omfånget. För att undvika ändringar i det aktuella omfånget måste du omsluta skriptblocket i klammerparenteser ({}) och använda anropsoperatorn (&) för att köra blocket i ett underordnat omfång.

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

Value 2
Value 2

Mer information om anropsoperatorn finns i about_Operators.

Parametrar

-Expression

Anger det uttryck som är tidsdelade. Omslut uttrycket i klammerparenteser ({}).

Typ:ScriptBlock
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Objekt som är bundna till parametern InputObject är valfria indata för skriptblocket som skickas till parametern Expression . I skriptblocket $_ kan användas för att referera till det aktuella objektet i pipelinen.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka ett objekt till den här cmdleten.

Utdata

TimeSpan

Den här cmdleten returnerar ett tidsintervallobjekt som representerar resultatet.