Measure-Object

Рассчитывает числовые свойства объектов, а также количество знаков, слов и строк в строковых объектах, например в текстовых файлах.

Синтаксис

Measure-Object [-Average] [-Maximum] [-Minimum] [-Sum] [[-Property] <string[]>] [-InputObject <psobject>] [<CommonParameters>]

Measure-Object [-Character] [-IgnoreWhiteSpace] [-Line] [-Word] [[-Property] <string[]>] [-InputObject <psobject>] [<CommonParameters>]

Описание

Командлет Measure-Object вычисляет значения свойств объектов определенного типа. Measure-Object выполняет измерения трех типов в зависимости от параметров команды.

Командлет Measure-Object выполняет вычисления, связанные со свойствами объектов. Он позволяет подсчитывать объекты, а также находить минимальные, максимальные, суммарные и средние числовые значения. Для текстовых объектов он позволяет подсчитывать число строк, слов и знаков.

Параметры

-Average

Отображает среднее значение для заданных свойств.

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

-Character

Подсчитывает количество знаков объекта ввода.

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

-IgnoreWhiteSpace

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

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

-InputObject <psobject>

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

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

-Line

Подсчитывает количество строк объекта ввода.

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

-Maximum

Отображает максимальное значение для заданных свойств.

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

-Minimum

Отображает минимальное значение для заданных свойств.

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

-Property <string[]>

Задает одно или более числовых свойств для измерения. По умолчанию используется свойство Count (Length) объекта.

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

-Sum

Отображает сумму значений заданных свойств.

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

-Word

Подсчитывает количество слов объекта ввода.

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

<CommonParameters>

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

Ввод и вывод

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

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

System.Management.Automation.PSObject

Объекты можно передать командлету Measure-Object по конвейеру.

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

GenericMeasureInfo или TextMeasureInfoObject

Пример 1

C:\PS>get-childitem | measure-object

Описание
-----------
Эта команда определяет число файлов и папок в текущем каталоге.

Пример 2

C:\PS>get-childitem | measure-object -property length -minimum -maximum -average

Описание
-----------
Эта команда отображает минимальный, максимальный, суммарный и средний размер всех файлов в текущем каталоге.

Пример 3

C:\PS>get-content C:\test.txt | measure-object -character -line -word

Описание
-----------
Эта команда отображает число знаков, слов и строк в файле Text.txt.

Пример 4

C:\PS>get-process | measure-object -property workingset -minimum -maximum -average

Описание
-----------
Эта команда отображает минимальный, максимальный и средний размер всех рабочих наборов процессов на компьютере.

Пример 5

C:\PS>import-csv d:\test\serviceyrs.csv | measure-object -property years -minimum -maximum -average

Описание
-----------
Команда вычисляет среднее время работы сотрудников в компании. 

ServiceYrs.csv — это CSV-файл, содержащий номера сотрудников и время работы каждого из сотрудников в годах. Первая строка таблицы представляет собой строку заголовков "EmpNo, Years".

При импорте файла с помощью командлета Import-Csv создается объект PSCustomObject, имеющий свойства-примечания EmpNo и Years. Командлет Measure-Object позволяет вычислить значения этих свойств, как для любых других свойств объекта.

Пример 6

C:\PS>get-childitem | measure-object -property psiscontainer -max -sum -min -average

Count    : 126
Average  : 0.0634920634920635
Sum      : 8
Maximum  : 1
Minimum  : 0
Property : PSIsContainer

Описание
-----------
В этом примере показано, что командлет Measure-Object позволяет измерять значения типа Boolean. В данном случае используется свойство PSIsContainer типа Boolean для измерения количества папок (файлов vs.) в текущем каталоге.