Measure-Object

Ссылка

Модуль:: Microsoft.PowerShell.Utility

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

Синтаксис

Measure-Object
       [[-Property] <PSPropertyExpression[]>]
       [-InputObject <PSObject>]
       [-StandardDeviation]
       [-Sum]
       [-AllStats]
       [-Average]
       [-Maximum]
       [-Minimum]
       [<CommonParameters>]

Measure-Object
       [[-Property] <PSPropertyExpression[]>]
       [-InputObject <PSObject>]
       [-Line]
       [-Word]
       [-Character]
       [-IgnoreWhiteSpace]
       [<CommonParameters>]

Описание

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

Командлет Measure-Object выполняет вычисления значений свойств объектов . Можно использовать для Measure-Object подсчета объектов или объектов с указанным свойством. Вы также можете использовать для Measure-Object вычисления значений Minimum, Maximum, Sum, StandardDeviation и Average числовых значений. Для объектов String можно также использовать для Measure-Object подсчета количества строк, слов и символов.

Примеры

Пример 1. Подсчет файлов и папок в каталоге

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

Get-ChildItem | Measure-Object

Пример 2. Измерение файлов в каталоге

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

Get-ChildItem | Measure-Object -Property length -Minimum -Maximum -Sum -Average

Пример 3. Измерение текста в текстовом файле

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

Первая команда использует Set-Content для добавления текста по умолчанию в файл.

"One", "Two", "Three", "Four" | Set-Content -Path C:\Temp\tmp.txt
Get-Content C:\Temp\tmp.txt | Measure-Object -Character -Line -Word

Lines Words Characters Property
----- ----- ---------- --------
    4     4         15

Пример 4. Измерение объектов, содержащих указанное свойство

В этом примере подсчитывается количество объектов со свойством DisplayName . Первые две команды извлекают все службы и процессы на локальном компьютере. Третья команда подсчитывает общее количество служб и процессов. Последняя команда объединяет две коллекции и передает результат в Measure-Object.

Объект System.Diagnostics.Process не имеет свойства DisplayName и не учитывается в окончательном подсчете.

$services = Get-Service
$processes = Get-Process
$services + $processes | Measure-Object
$services + $processes | Measure-Object -Property DisplayName

Count    : 682
Average  :
Sum      :
Maximum  :
Minimum  :
Property :

Count    : 290
Average  :
Sum      :
Maximum  :
Minimum  :
Property : DisplayName

Пример 5. Измерение содержимого CSV-файла

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

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

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

Import-Csv d:\test\serviceyrs.csv | Measure-Object -Property years -Minimum -Maximum -Average

Пример 6. Измерение логических значений

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

Get-ChildItem | Measure-Object -Property psiscontainer -Maximum -Sum -Minimum -Average

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

Пример 7. Строки мер

В следующем примере измеряется количество строк, сначала одна строка, а затем несколько строк. Символ `n новой строки разделяет строки на несколько строк.

# The newline character `n separates the string into separate lines, as shown in the output.
"One`nTwo`nThree"
"One`nTwo`nThree" | Measure-Object -Line

One
Two
Three


Lines Words Characters Property
----- ----- ---------- --------
    3

# The first string counts as a single line.
# The second string is separated into two lines by the newline character.
"One", "Two`nThree" | Measure-Object -Line

Lines Words Characters Property
----- ----- ---------- --------
    3

# The Word switch counts the number of words in each InputObject
# Each InputObject is treated as a single line.
"One, Two", "Three", "Four Five" | Measure-Object -Word -Line

Lines Words Characters Property
----- ----- ---------- --------
    3     5

Пример 8. Измерение всех значений

Начиная с PowerShell 6 параметр Measure-ObjectAllStats позволяет измерять всю статистику вместе.

1..5 | Measure-Object -AllStats

Count             : 5
Average           : 3
Sum               : 15
Maximum           : 5
Minimum           : 1
StandardDeviation : 1.58113883008419
Property          :

Пример 9. Измерение с помощью свойств scriptblock

Начиная с PowerShell 6, Measure-Object поддерживает свойства ScriptBlock . В следующем примере показано, как использовать свойство ScriptBlock для определения размера (в мегабайтах) всех файлов в каталоге.

Get-ChildItem | Measure-Object -Sum {$_.Length/1MB}

Пример 10. Хэш-таблицы мер

Начиная с PowerShell 6, Measure-Object поддерживает измерение входных данных хэш-схемы . В следующем примере определяется наибольшее значение для num ключа из трех объектов хэш-сводки .

@{num=3}, @{num=4}, @{num=5} | Measure-Object -Maximum Num

Count             : 3
Average           :
Sum               :
Maximum           : 5
Minimum           :
StandardDeviation :
Property          : num

Пример 11. Измерение стандартного отклонения

Начиная с PowerShell 6, Measure-Object поддерживает -StandardDeviation параметр . В следующем примере определяется стандартное отклонение для ЦП, используемого всеми процессами. Большое отклонение указывает на небольшое количество процессов, потребляющих большую часть ЦП.

Get-Process | Measure-Object -Average -StandardDeviation CPU

Count             : 303
Average           : 163.032384488449
Sum               :
Maximum           :
Minimum           :
StandardDeviation : 859.444048419069
Property          : CPU

Пример 12. Измерение с помощью подстановочных знаков

Начиная с PowerShell 6, Measure-Object поддерживает измерение объектов с помощью подстановочных знаков в именах свойств. В следующем примере определяется максимальное значение любого типа использования постраничной памяти в наборе процессов.

Get-Process | Measure-Object -Maximum *paged*memory*size

Count             : 303
Average           :
Sum               :
Maximum           : 735784
Minimum           :
StandardDeviation :
Property          : NonpagedSystemMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 352104448
Minimum           :
StandardDeviation :
Property          : PagedMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 2201968
Minimum           :
StandardDeviation :
Property          : PagedSystemMemorySize

Count             : 303
Average           :
Sum               :
Maximum           : 719032320
Minimum           :
StandardDeviation :
Property          : PeakPagedMemorySize

Параметры

-AllStats

Указывает, что командлет отображает всю статистику указанных свойств.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Average

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Character

Указывает, что командлет подсчитывает количество символов во входных объектах.

Примечание

Переключатели Word, Char и Lineучитываются внутри каждого входного объекта, а также между входными объектами. См. пример 7.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IgnoreWhiteSpace

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

При использовании параметра InputObject с Measure-Objectвместо отправки результатов Measure-Objectкоманды в значение InputObject обрабатывается как один объект.

Рекомендуется использовать Measure-Object в конвейере, если требуется измерить коллекцию объектов на основе того, имеют ли объекты определенные значения в определенных свойствах.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Line

Указывает, что командлет подсчитывает количество строк во входных объектах.

Примечание

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Maximum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Minimum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Задает одно или несколько свойств для измерения. Если другие меры не указаны, Measure-Object подсчитывает объекты с указанными свойствами.

Значение параметра Property может быть новым вычисляемым свойством. Вычисляемое свойство должно быть блоком скрипта. Дополнительные сведения см. в разделе about_Calculated_Properties.

Type:	PSPropertyExpression[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-StandardDeviation

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Sum

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Word

Указывает, что командлет подсчитывает количество слов во входных объектах.

Примечание

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

PSObject

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

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

GenericMeasureInfo

По умолчанию этот командлет возвращает объект GenericMeasureInfo .

TextMeasureInfo

При использовании параметра Word этот командлет возвращает объект TextMeasureInfo.

Примечания

PowerShell включает следующие псевдонимы для Measure-Object:

Для всех платформ.
- measure

Начиная с PowerShell 7.3, больше не возвращает ошибку при обработке объекта, в котором отсутствует измеряемое свойство, Measure-Object если только вы не работаете в StrictMode. В StrictMode возвращает при System.Management.Automation.PSArgumentException обработке объекта, Measure-Object в который отсутствует указанное свойство.

Поделиться через

Measure-Object

Синтаксис

Описание

Примеры

Пример 1. Подсчет файлов и папок в каталоге

Пример 2. Измерение файлов в каталоге

Пример 3. Измерение текста в текстовом файле

Пример 4. Измерение объектов, содержащих указанное свойство

Пример 5. Измерение содержимого CSV-файла

Пример 6. Измерение логических значений

Пример 7. Строки мер

Пример 8. Измерение всех значений

Пример 9. Измерение с помощью свойств scriptblock

Пример 10. Хэш-таблицы мер

Пример 11. Измерение стандартного отклонения

Пример 12. Измерение с помощью подстановочных знаков

Параметры

-AllStats

-Average

-Character

-IgnoreWhiteSpace

-InputObject

-Line

-Maximum

-Minimum

-Property

-StandardDeviation

-Sum

-Word

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

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

Примечания

Дополнительные ресурсы

Поделиться через

Measure-Object

Синтаксис

Описание

Примеры

Пример 1. Подсчет файлов и папок в каталоге

Пример 2. Измерение файлов в каталоге

Пример 3. Измерение текста в текстовом файле

Пример 4. Измерение объектов, содержащих указанное свойство

Пример 5. Измерение содержимого CSV-файла

Пример 6. Измерение логических значений

Пример 7. Строки мер

Пример 8. Измерение всех значений

Пример 9. Измерение с помощью свойств scriptblock

Пример 10. Хэш-таблицы мер

Пример 11. Измерение стандартного отклонения

Пример 12. Измерение с помощью подстановочных знаков

Параметры

-AllStats

-Average

-Character

-IgnoreWhiteSpace

-InputObject

-Line

-Maximum

-Minimum

-Property

-StandardDeviation

-Sum

-Word

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

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

Примечания

Связанные ссылки

Дополнительные ресурсы