Measure-Object
计算对象的数值属性,以及字符串对象(如文本文件)中的字符、字词和行。
语法
		GenericMeasure (默认值)
	 
	Measure-Object
    [[-Property] <String[]>]
    [-InputObject <PSObject>]
    [-Sum]
    [-Average]
    [-Maximum]
    [-Minimum]
    [<CommonParameters>]
	
		TextMeasure
	 
	Measure-Object
    [[-Property] <String[]>]
    [-InputObject <PSObject>]
    [-Line]
    [-Word]
    [-Character]
    [-IgnoreWhiteSpace]
    [<CommonParameters>]
	说明
              Measure-Object cmdlet 计算某些类型的对象的属性值。
              Measure-Object 根据命令中的参数执行三种类型的度量。
              Measure-Object cmdlet 对对象的属性值执行计算。 可以使用 Measure-Object 对具有指定 属性的对象进行计数或计数。 还可以使用 Measure-Object 来计算 最小值、最大值、总和、StandardDeviation 和 数值的平均。 对于 字符串 对象,还可以使用 Measure-Object 对行数、单词和字符数进行计数。
示例
示例 1:对目录中的文件和文件夹进行计数
此命令对当前目录中的文件和文件夹进行计数。
Get-ChildItem | Measure-Object
	示例 2:测量目录中的文件
此命令显示 最小、最大,以及当前目录中所有文件的大小 和总和,以及目录中文件的平均大小。
Get-ChildItem | Measure-Object -Property Length -Minimum -Maximum -Sum -Average
	示例 3:度量文本文件中的文本
此命令显示 Text.txt 文件中的字符数、单词和行数。
如果没有 Raw 参数,Get-Content 将文件输出为行数组。
第一个命令使用 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的标题行,年。
使用 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
	参数
-Average
指示 cmdlet 显示指定属性的平均值。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					GenericMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Character
指示 cmdlet 对输入对象中的字符数进行计数。
注释
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					TextMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-IgnoreWhiteSpace  
		指示 cmdlet 忽略字符计数中的空格。 默认情况下,不会忽略空格。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					TextMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-InputObject 
		指定要测量的对象。 输入包含对象的变量,或键入获取对象的命令或表达式。
将 InputObject 参数与  命令结果一起使用Measure-Object时,Measure-Object 值被视为单个对象,而不是管道命令结果。
如果要根据对象是否具有定义属性中的特定值来度量对象的集合,建议在管道中使用 Measure-Object。
参数属性
| 类型: | PSObject | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
(All)
| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | True | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Line
指示 cmdlet 对输入对象中的行数进行计数。
注释
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					TextMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Maximum
指示 cmdlet 显示指定属性的最大值。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					GenericMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Minimum
指示 cmdlet 显示指定属性的最小值。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					GenericMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Property
指定要度量的一个或多个属性。 如果未指定任何其他度量值,Measure-Object 计算具有指定属性的对象。
参数属性
| 类型: | String[]  | 
| 默认值: | None | 
| 支持通配符: | True | 
| 不显示: | False | 
参数集
(All)
| Position: | 0 | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Sum
指示 cmdlet 显示指定属性的值的总和。
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					GenericMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-Word
指示 cmdlet 对输入对象中的单词数进行计数。
注释
参数属性
| 类型: | SwitchParameter | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					TextMeasure 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
PSObject
可以通过管道将对象传递给此 cmdlet。
输出
GenericMeasureInfo
默认情况下,此 cmdlet 返回 GenericMeasureInfo 对象。
TextMeasureInfo
使用 Word 参数时,此 cmdlet 将返回 TextMeasureInfo 对象。
备注
Windows PowerShell 为 Measure-Object提供以下别名:
measure