Измеряет время выполнения блоков скриптов и командлетов.

Синтаксис

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

Описание

Командлет Measure-Command выполняет во внутреннем контексте блок скрипта или командлет, измеряет время выполнения операции и возвращает полученное значение.

Параметры

-Expression <scriptblock>

Задает выражение, длительность выполнения которого нужно определить. Заключайте выражение в фигурные скобки ({}). Имя параметра ("-Expression") указывать необязательно.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-InputObject <psobject>

Задает объекты, представляющие выражения для измерения. Введите переменную, содержащую объекты, либо получающую их команду или выражение.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

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.

Measure-Command