測量執行指令碼區塊和 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 參數) 所需要的時間。
請參閱