計算物件的數值屬性,以及字串物件 (如文字檔) 中的字元數、字數、和行數。

語法

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 屬性來測量目前目錄中資料夾的出現次數 (相對於檔案)。






請參閱




目錄