powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Measure-Command



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 retu
rns the execution time.


PARAMETERS
-Expression
Specifies the expression that is being timed. Enclose the expression in curly braces ({}). The parameter name (
"Expression") is optional.

Required? true
Position? 1
Default value
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 ty
pe a command or expression that gets the objects.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
System.Management.Automation.PSObject
You can pipe an object to Measure-Command.


OUTPUTS
System.TimeSpan
Measure-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 Meas
ure-Command -full".

When specifying multiple values for a parameter, use commas to separate the values. For example, " ame> , ".


-------------------------- EXAMPLE 1 --------------------------

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


Description
-----------
This command measures the time it takes to run a "get-eventlog" command that gets the events in the Windows PowerSh
ell event log.





-------------------------- EXAMPLE 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


Description
-----------
These 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 Include parameter. The secon
d command measures the time it takes to process a recursive Get-ChildItem command that uses the provider-specific F
ilter parameter.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113348
Trace-Command
Invoke-Command