Measure-Command

度量运行脚本块和 cmdlet 所用的时间。

语法

Measure-Command [-表达式] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]

说明

Measure-Command cmdlet 在内部运行脚本块或 cmdlet,并度量执行操作的时间,然后返回执行时间。

参数

-表达式 <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" }

说明
-----------
此命令度量运行一个获取 Windows PowerShell 事件日志中的事件的“get-eventlog”命令所用的时间。





示例 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 命令中使用特定于提供程序的筛选器的值。第一个命令度量处理使用 Include 参数的递归 Get-ChildItem 命令所用的时间。第二个命令度量处理使用提供程序特定 Filter 参数的递归 Get-ChildItem 命令所用的时间。





另请参阅

概念

Trace-Command
Invoke-Command