NAME
Measure-Command
SYNOPSIS
Measures the time it takes to run script blocks and cmdlets.SYNTAX
Measure-Command [-Expression]
[-InputObject ] [ ] DESCRIPTION
The Measure-Command cmdlet runs a script block or cmdlet internally, times the execution of the operation, and
returns the execution time.PARAMETERS
-Expression
Specifies the expression that is being timed. Enclose the expression in braces ({}). The parameter name ("Expression") is optional. Required? true Position? 0 Default value None Accept pipeline input? False Accept wildcard characters? false-InputObject
Specifies objects representing the expressions to be measured. Enter a variable that contains the objects or type a command or expression that gets the objects. Required? false Position? named Default value None Accept pipeline input? True (ByValue) Accept wildcard characters? falseThis cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). INPUTS
System.Management.Automation.PSObjectYou can pipe an object to Measure-Command .
OUTPUTS
System.TimeSpanMeasure-Command returns a time span object that represents the result.
NOTES
* For more information, type `Get-Help Measure-Command -detailed`. For technical information, type `Get-Help
Measure-Command -full`.
When specifying multiple values for a parameter, use commas to separate the values. For example,
, . *
Example 1: Measure the time to run a command
PS C:\>Measure-Command { Get-EventLog "windows powershell" }
This command measures the time it takes to run a Get-EventLog command that gets the events in the Windows
PowerShell event log.Example 2: Use a provider-specific filter
PS C:\>Measure-Command {Get-ChildItem -Path C:\Windows\*.txt -Recurse}
Days : 0 Hours : 0 Minutes : 0 Seconds : 8 Milliseconds : 618 Ticks : 86182763TotalDays : 9.9748568287037E-05
TotalHours : 0.00239396563888889 TotalMinutes : 0.143637938333333 TotalSeconds : 8.6182763TotalMilliseconds : 8618.2763 PS C:\>Measure-Command {Get-ChildItem C:\Windows -Filter "*.txt" -Recurse}
PS C:\>
Days : 0 Hours : 0 Minutes : 0 Seconds : 1 Milliseconds : 140 Ticks : 11409189TotalDays : 1.32050798611111E-05
TotalHours : 0.000316921916666667 TotalMinutes : 0.019015315 TotalSeconds : 1.1409189 TotalMilliseconds : 1140.9189These commands show the value of using a provider-specific filter in Windows PowerShell commands.
The first command measures the time it takes to process a recursive Get-ChildItem command that uses the Path
parameter to get only .txt files in the C:\Windows directory and its subdirectories.The second command measures the time it takes to process a recursive Get-ChildItem command that uses the
provider-specific Filter parameter.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821828Trace-Command