Measure-Object
オブジェクトの数値プロパティと、テキストのファイルなど文字列オブジェクト内の文字、単語、および行を計算します。
構文
Measure-Object
[-InputObject <PSObject>]
[[-Property] <String[]>]
[-Sum]
[-Average]
[-Maximum]
[-Minimum]
[<CommonParameters>]Measure-Object
[-InputObject <PSObject>]
[[-Property] <String[]>]
[-Line]
[-Word]
[-Character]
[-IgnoreWhiteSpace]
[<CommonParameters>]説明
コマンドレットは Measure-Object 、特定の種類のオブジェクトのプロパティ値を計算します。
Measure-Object は、コマンドのパラメーターに応じて 3 種類の測定を実行します。
このコマンドレットは Measure-Object 、オブジェクトのプロパティ値に対して計算を実行します。 指定したプロパティを使用して、オブジェクトのカウントやオブジェクトのカウントに使用Measure-Objectできます。 また、数値の最小値、最大値、合計、StandardDeviation、および平均を計算するためにも使用Measure-Objectできます。 String オブジェクトの場合は、行、単語、および文字の数をカウントするために使用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 プロパティを持つオブジェクトの数を カウントします 。 最初の 2 つのコマンドは、ローカル コンピューター上のすべてのサービスとプロセスを取得します。 3 番目のコマンドは、サービスとプロセスの組み合わせ数をカウントします。 最後のコマンドは、2 つのコレクションを結合し、結果 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すると、結果は EmpNo と Years のメモ プロパティを持つ PSCustomObject になります。
オブジェクトの他のプロパティと同様に、これらのプロパティの値を計算するために使用 Measure-Object できます。
Import-Csv d:\test\serviceyrs.csv | Measure-Object -Property years -Minimum -Maximum -Average例 6: ブール値を測定する
この例では、ブール値を Measure-Object 測定する方法を示します。
この場合、PSIsContainerBoolean プロパティを使用して、現在のディレクトリ内のフォルダー (ファイル) の発生率を測定します。
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: 文字列を測定する
次の例では、行数を測定し、最初に 1 つの文字列を、次に複数の文字列にわたって測定します。 改行文字は、 `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
指定したプロパティの平均値がコマンドレットに表示されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Character
コマンドレットが入力オブジェクトの文字数をカウントすることを示します。
Note
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
測定するオブジェクトを指定します。 オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。
コマンドの結果Measure-Objectをパイプ処理する代わりに InputObject パラメーターをMeasure-Object使用すると、InputObject 値は 1 つのオブジェクトとして扱われます。
定義されたプロパティにオブジェクトが特定の値を持っているかどうかに基づいてオブジェクトのコレクションを測定する場合は、パイプラインで使用 Measure-Object することをお勧めします。
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Line
コマンドレットが入力オブジェクトの行数をカウントすることを示します。
Note
Word、Char、Line スイッチは、入力オブジェクト間だけでなく、各入力オブジェクト内のカウントも切り替えます。 例 7 を参照してください。
| 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
測定する 1 つ以上のプロパティを指定します。 他のメジャーを指定しない場合は、 Measure-Object 指定したプロパティを持つオブジェクトをカウントします。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Sum
指定したプロパティの値の合計がコマンドレットに表示されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Word
コマンドレットが入力オブジェクト内の単語数をカウントすることを示します。
Note
Word、Char、Line スイッチは、入力オブジェクト間だけでなく、各入力オブジェクト内のカウントも切り替えます。 例 7 を参照してください。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
このコマンドレットにオブジェクトをパイプできます。
出力
既定では、このコマンドレットは GenericMeasureInfo オブジェクトを返します。
Word パラメーターを使用すると、このコマンドレットは TextMeasureInfo オブジェクトを返します。
メモ
Windows PowerShell には、次のエイリアスが Measure-Object含まれています。
measure
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示