計算物件的數值屬性，以及字串物件 (如文字檔) 中的字元數、字數、和行數。
語法
Measure-Object [-Average] [-Maximum] [-Minimum] [-Sum] [[-屬性] <string[]>] [-InputObject <psobject>] [<CommonParameters>] Measure-Object [-Character] [-IgnoreWhiteSpace] [-Line] [-Word] [[-Property] <string[]>] [-InputObject <psobject>] [<CommonParameters>]
描述
Measure-Object Cmdlet 會計算物件之特定類型的屬性值，Measure-Object 會根據此命令中的參數來執行三種類型的測量。
Measure-Object Cmdlet 會對物件的屬性值執行計算。它不但能計算物件數，也能計算數值的最小值、最大值、總和值及平均值。對文字物件，它還能計算行數、字數和字元數。
參數
-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>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
|
輸入 |
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 匯入這個檔案時，結果會是 note 屬性為 EmpNo 和 Years 的 PSCustomObject。您可以使用 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 可以測量布林值。在此案例中，它會使用 PSIsContainer Boolean 屬性來測量目前目錄中資料夾的出現次數 (相對於檔案)。
請參閱