Measure-Command (Microsoft.PowerShell.Utility)

Measure-Command

Модуль:

Microsoft.PowerShell.Utility

Измеряет время, необходимое для запуска блоков сценариев и командлетов.

Синтаксис

Measure-Command
       [-InputObject <PSObject>]
       [-Expression] <ScriptBlock>
       [<CommonParameters>]

Описание

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

Примеры

Пример 1: Измерение команды

В этом примере измеряется время, необходимое для запуска команды Get-EventLog, которая получает события из журнала событий Windows PowerShell.

Measure-Command { Get-EventLog "windows powershell" }

Пример 2. Сравните два результата команды Measure-Command.

Первая команда измеряет время, необходимое для обработки рекурсивной команды Get-ChildItem, которая использует параметр Path для получения только файлов .txt в Каталог C:\Windows и его подкаталоги.

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

Эти команды показывают ценность использования фильтра, специфичного для поставщика, в командах PowerShell.

Measure-Command { Get-ChildItem -Path C:\Windows\*.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

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

Пример 3: Входные данные трубопровода для команды измерения

Объекты, передаваемые по конвейеру в Measure-Command, доступны блоку сценария, который передается в параметр Expression. Блок сценария выполняется один раз для каждого объекта в конвейере.

# Perform a simple operation to demonstrate the InputObject parameter
# Note that no output is displayed.
10, 20, 50 | Measure-Command -Expression { for ($i=0; $i -lt $_; $i++) {$i} }

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 0
Milliseconds      : 12
Ticks             : 122672
TotalDays         : 1.41981481481481E-07
TotalHours        : 3.40755555555556E-06
TotalMinutes      : 0.000204453333333333
TotalSeconds      : 0.0122672
TotalMilliseconds : 12.2672

Пример 4: Отображение вывода измеренной команды

Чтобы отобразить вывод выражения в Measure-Command, вы можете использовать канал для Out-Default.

# Perform the same operation as above adding Out-Default to every execution.
# This will show that the ScriptBlock is in fact executing for every item.
10, 20, 50 | Measure-Command -Expression {for ($i=0; $i -lt $_; $i++) {$i}; "$($_)" | Out-Default }

10
20
50


Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 0
Milliseconds      : 11
Ticks             : 113745
TotalDays         : 1.31649305555556E-07
TotalHours        : 3.15958333333333E-06
TotalMinutes      : 0.000189575
TotalSeconds      : 0.0113745
TotalMilliseconds : 11.3745

Пример 5. Измерение выполнения в дочерней области

Measure-Command запускает блок сценария в текущей области, поэтому блок сценария может изменять значения в текущей области. Чтобы избежать изменений в текущей области, необходимо заключить блок сценария в фигурные скобки ({}) и использовать оператор вызова (&) для выполнения блока в дочерней области. .

$foo = 'Value 1'
$null = Measure-Command { $foo = 'Value 2' }
$foo
$null = Measure-Command { & { $foo = 'Value 3' } }
$foo

Value 2
Value 2

Дополнительные сведения об операторе вызова см. в разделе about_Operators.

Параметры

-Expression

Указывает выражение, для которого выполняется синхронизация. Заключите выражение в фигурные скобки ({}).

Тип :

ScriptBlock

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-InputObject

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

Тип :

PSОбъект

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

Входы

PSObject

Вы можете передать объект этому командлету.

Выходы

Временной интервал

Этот командлет возвращает объект временного интервала, представляющий результат.