Measure-Command

Měří dobu potřebnou ke spuštění bloků skriptu a rutin.

Syntaxe

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

Description

Rutina Measure-Command spouští blok skriptu nebo rutinu interně, čas spuštění operace a vrátí čas spuštění.

Poznámka:

Bloky skriptu spouštěné spuštěním Measure-Command v aktuálním oboru, nikoli podřízeným oborem.

Příklady

Příklad 1: Měření příkazu

Tento příklad měří dobu potřebnou ke spuštění Get-EventLog příkazu, který získá události v protokolu událostí Windows PowerShellu.

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

Příklad 2: Porovnání dvou výstupů z příkazu Measure-Command

První příkaz měří dobu potřebnou ke zpracování rekurzivního Get-ChildItem příkazu, který pomocí parametru Path získá pouze .txt soubory v C:\Windows adresáři a jeho podadresářích.

Druhý příkaz měří dobu potřebnou ke zpracování rekurzivního Get-ChildItem příkazu, který používá parametr Filter specifický pro zprostředkovatele.

Tyto příkazy zobrazují hodnotu použití filtru specifického pro zprostředkovatele v příkazech PowerShellu.

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

Příklad 3: Převod vstupu do příkazu measure-command

Objekty, které jsou předané Measure-Command do bloku skriptu, který je předán parametru Expression . Blok skriptu se spustí jednou pro každý objekt v kanálu.

# 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

Příklad 4: Zobrazení výstupu měřeného příkazu

Chcete-li zobrazit výstup výrazu v Measure-Command aplikaci, můžete použít svislé roury k 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

Příklad 5: Měření provádění v podřízené oblasti

Measure-Command spustí blok skriptu v aktuálním oboru, takže blok skriptu může upravovat hodnoty v aktuálním oboru. Chcete-li zabránit změnám aktuálního oboru, je nutné zabalit blok skriptu do složených závorek ({}) a pomocí operátoru vyvolání (&) spustit blok v podřízenému oboru.

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

Value 2
Value 2

Další informace o operátoru vyvolání najdete v tématu about_Operators.

Parametry

-Expression

Určuje výraz, který je časován. Uzavřete výraz do složených závorek ({}).

Typ:ScriptBlock
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Objekty vázané na parametr InputObject jsou volitelný vstup pro blok skriptu předaný do parametru Expression . Uvnitř bloku $_ skriptu lze použít odkaz na aktuální objekt v kanálu.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

PSObject

Objekt můžete do této rutiny převést.

Výstupy

TimeSpan

Tato rutina vrátí objekt časového rozsahu představující výsledek.