Measure-Command

發行項
10/30/2009

測量執行指令碼區塊和 cmdlet 所需要的時間。

語法

Measure-Command [-Expression] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]

描述

Measure-Command Cmdlet 會在內部執行指令碼區塊或 Cmdlet、為作業的執行計時，然後傳回執行時間。

參數

-Expression <scriptblock>

指定所要計時的運算式。將運算式置於大括號 ({}) 內。參數名稱 ("Expression") 為選擇性。

必要?	true
位置?	1
預設值
接受管線輸入?	false
接受萬用字元?	false

-InputObject <psobject>

指定代表要測量之運算式的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。

必要?	false
位置?	named
預設值
接受管線輸入?	true (ByValue)
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將物件輸出至 Measure-Command。

輸出

System.TimeSpan

Measure-Command 會傳回代表結果的時間範圍物件。

附註

如需詳細資訊，請輸入 "Get-Help Measure-Command -detailed"。如需技術資訊，請輸入 "Get-Help Measure-Command -full"。

若要為參數指定多重數值，請使用逗號來分隔數值。例如："<參數名稱> <值1>, <值2>"。

範例 1

C:\PS>Measure-Command { get-eventlog "windows powershell" }

描述
-----------
此命令會測量執行 "get-eventlog" 命令所花的時間，該命令會取得 Windows PowerShell 事件記錄檔中的事件。

範例 2

C:\PS>measure-command {get-childitem c:\windows -include *.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

C:\PS>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

描述
-----------
這些命令顯示 Windows PowerShell 命令中使用的提供者特定篩選器的值。第一個命令會測量處理遞迴 Get-ChildItem 命令 (該命令使用 Include 參數) 所需要的時間。第二個命令會測量處理遞迴 Get-ChildItem 命令 (該命令使用提供者特定的 Filter 參數) 所需要的時間。

請參閱

概念

Trace-Command
Invoke-Command

共用方式為