Delen via

Measure-Command

  • Referentie
Module:
Microsoft.PowerShell.Utility

Meet de tijd die nodig is om scriptblokken en cmdlets uit te voeren.

Syntaxis

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

Description

De Measure-Command cmdlet voert intern een scriptblok of cmdlet uit, keert de uitvoering van de bewerking en retourneert de uitvoeringstijd.

Notitie

Scriptblokken worden uitgevoerd door Measure-Command uit te voeren in het huidige bereik, niet een onderliggend bereik.

Voorbeelden

Voorbeeld 1: Een opdracht meten

In dit voorbeeld wordt de tijd berekend die nodig is om een Get-EventLog opdracht uit te voeren waarmee de gebeurtenissen in het Windows PowerShell-gebeurtenislogboek worden opgeslagen.

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

Voorbeeld 2: Twee uitvoer van Measure-Command vergelijken

De eerste opdracht meet de tijd die nodig is voor het verwerken van een recursieve Get-ChildItem opdracht die gebruikmaakt van de parameter Path om alleen .txt bestanden in de C:\Windows map en de bijbehorende submappen op te halen.

De tweede opdracht meet de tijd die nodig is voor het verwerken van een recursieve Get-ChildItem opdracht die gebruikmaakt van de providerspecifieke filterparameter .

Deze opdrachten geven de waarde weer van het gebruik van een providerspecifiek filter in PowerShell-opdrachten.

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

Voorbeeld 3: Invoer van piping naar Measure-Command

Objecten die worden doorgesluisd Measure-Command , zijn beschikbaar voor het scriptblok dat wordt doorgegeven aan de expressieparameter . Het scriptblok wordt eenmaal uitgevoerd voor elk object in de pijplijn.

# 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

Voorbeeld 4: Uitvoer van gemeten opdracht weergeven

Als u de uitvoer van expressies wilt weergeven, Measure-Command kunt u een pipe gebruiken om 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

Voorbeeld 5: Uitvoering meten in een onderliggend bereik

Measure-Command voert het scriptblok in het huidige bereik uit, zodat het scriptblok waarden in het huidige bereik kan wijzigen. Als u wijzigingen in het huidige bereik wilt voorkomen, moet u het scriptblok tussen accolades ({}) verpakken en de aanroepoperator (&) gebruiken om het blok in een onderliggend bereik uit te voeren.

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

Value 2
Value 2

Zie about_Operators voor meer informatie over de aanroepoperator.

Parameters

-Expression

Hiermee geeft u de expressie die wordt getimed. Plaats de expressie tussen accolades ({}).

Type:ScriptBlock
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Objecten die zijn gebonden aan de parameter InputObject zijn optionele invoer voor het scriptblok dat wordt doorgegeven aan de expressieparameter . In het scriptblok $_ kan worden gebruikt om te verwijzen naar het huidige object in de pijplijn.

Type:PSObject
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt een object doorsluisen naar deze cmdlet.

Uitvoerwaarden

TimeSpan

Deze cmdlet retourneert een tijdsspanneobject dat het resultaat vertegenwoordigt.