Measure-Command
スクリプト ブロックとコマンドレットの実行にかかる時間を測定します。
構文
Measure-Command
[-InputObject <PSObject>]
[-Expression] <ScriptBlock>
[<CommonParameters>]
説明
Measure-Command
コマンドレットは、スクリプト ブロックまたはコマンドレットを内部的に実行し、操作の実行時間を返し、実行時間を返します。
例
例 1: コマンドを測定する
このコマンドは、Windows PowerShell イベント ログのイベントを取得する Get-EventLog
コマンドの実行にかかる時間を測定します。
Measure-Command { Get-EventLog "windows powershell" }
例 2: Measure-Command からの 2 つの出力を比較する
最初のコマンドは、Get-ChildItem
パラメーターを使用して C:\Windows ディレクトリとそのサブディレクトリ内の .txt ファイルのみを取得する再帰的な -Path
コマンドの処理にかかる時間を測定します。
2 番目のコマンドは、プロバイダー固有の Get-ChildItem
パラメーターを使用する再帰的な -Filter
コマンドの処理にかかる時間を測定します。
これらのコマンドは、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 の InputObject パラメーターを使用する
この例では、InputObject
の Measure-Command
パラメーターを使用する方法を示します。
ScriptBlock
パラメータに渡されたExpression
は、渡されたオブジェクト (InputObject
パラメータにパイプされたオブジェクトごとに 1 回実行されます。
注
Measure-Command
still は、ScriptBlock
パラメーターに渡されたすべての要素の全体的なInputObject
実行の測定値を提供します。
# 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
パラメーター
-Expression
時間指定する式を指定します。 式は波かっこ ({}) で囲みます。 パラメータ名 ("Expression") はオプションです。
型: | ScriptBlock |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
InputObject
パラメータにバインドされたオブジェクトは、ScriptBlock
パラメータに渡されるExpression
のオプション入力です。
ScriptBlock
内では、$_
を使用してパイプライン内の現在のオブジェクトを参照できます。
型: | PSObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
オブジェクトを Measure-Command
にパイプでつなぐことができます。
出力
Measure-Command
結果を表す Time Span オブジェクトを返します。