次の方法で共有

Measure-Command

  • リファレンス
モジュール:
Microsoft.PowerShell.Utility

スクリプト ブロックとコマンドレットの実行に要する時間を計測します。

構文

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

説明

Measure-Command コマンドレットは、スクリプト ブロックまたはコマンドレットを内部的に実行し、操作の実行時間を返し、実行時間を返します。

Note

スクリプト ブロックは、子スコープではなく、現在のスコープで実行 Measure-Command によって実行されます。

例

例 1: コマンドを測定する

次の使用例は、Windows PowerShell イベント ログのイベントを取得する Get-EventLog コマンドの実行にかかる時間を測定します。

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

例 2: Measure-Command からの 2 つの出力を比較する

最初のコマンドは、Path パラメーターを使用して、C:\Windows ディレクトリとそのサブディレクトリ内の.txt ファイルのみを取得する再帰的なGet-ChildItem コマンドの処理にかかる時間を測定します。

2 番目のコマンドは、プロバイダー固有の Filter パラメーターを使用する再帰的なGet-ChildItem コマンドの処理にかかる時間を測定します。

これらのコマンドは、PowerShell コマンドでプロバイダー固有のフィルターを使用する値を示します。

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

例 3: Measure-Command へのパイプ入力

Measure-Commandにパイプされたオブジェクトは、Expression パラメーターに渡されるスクリプト ブロックで使用できます。 スクリプト ブロックは、パイプライン上のオブジェクトごとに 1 回実行されます。

# 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

例 4: 測定されたコマンドの出力を表示する

式の出力を Measure-Command に表示するには、パイプを使用して 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

例 5: 子スコープでの実行の測定

Measure-Command はスクリプト ブロックを現在のスコープで実行するため、スクリプト ブロックは現在のスコープ内の値を変更できます。 現在のスコープの変更を回避するには、スクリプト ブロックを中かっこ ({}) でラップし、呼び出し演算子 (&) を使用して子スコープでブロックを実行する必要があります。

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

Value 2
Value 2

呼び出し演算子の詳細については、 about_Operatorsを参照してください。

パラメーター

-Expression

時間の計測する式を指定します。 式を中かっこ ({}) で囲みます。

型:ScriptBlock
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

InputObject パラメーターにバインドされたオブジェクトは、Expression パラメーターに渡されるスクリプト ブロックの省略可能な入力です。 スクリプト ブロック内では、 $_ を使用してパイプライン内の現在のオブジェクトを参照できます。

型:PSObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

PSObject

このコマンドレットには、オブジェクトをパイプ処理できます。

出力

TimeSpan

このコマンドレットは、結果を表す期間オブジェクトを返します。