Berechnet die numerischen Eigenschaften von Objekten sowie die Zeichen, Wörter und Zeilen in Zeichenfolgenobjekten, z. B. Textdateien.

Syntax

Measure-Object [-Average] [-Maximum] [-Minimum] [-Sum] [[-Eigenschaft] <string[]>] [-InputObject <psobject>] [<CommonParameters>]

Measure-Object [-Character] [-IgnoreWhiteSpace] [-Line] [-Word] [[-Eigenschaft] <string[]>] [-InputObject <psobject>] [<CommonParameters>]

Beschreibung

Das Cmdlet "Measure-Object" berechnet die Eigenschaftenwerte bestimmter Objekttypen. Measure-Object führt je nach den Parametern im Befehl drei Arten von Messungen aus.

Mit dem Cmdlet "Measure-Object" werden die Eigenschaftenwerte von Objekten berechnet. Mit ihm werden Objekte gezählt und Minimum, Maximum, Summe und Mittelwert der numerischen Werte berechnet. Bei Textobjekten werden mit ihm die Anzahl von Zeilen, Wörtern und Zeichen gezählt und berechnet.

Parameter

-Average

Zeigt den Mittelwert der angegebenen Eigenschaften an.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Character

Zählt die Anzahl der Zeichen im Eingabeobjekt.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-IgnoreWhiteSpace

Ignoriert Leerzeichen bei der Zählung von Wörtern und Zeichen. Leerzeichen werden standardmäßig nicht ignoriert.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-InputObject <psobject>

Gibt die zu messenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue)

Platzhalterzeichen akzeptieren?

false

-Line

Zählt die Anzahl der Zeilen im Eingabeobjekt.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Maximum

Zeigt den Höchstwert der angegebenen Eigenschaften an.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Minimum

Zeigt den Mindestwert der angegebenen Eigenschaften an.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Eigenschaft <string[]>

Gibt eine oder mehrere numerische Eigenschaften an, die gemessen werden sollen. Der Standardwert ist die Count-Eigenschaft (Length) des Objekts.

Erforderlich?

false

Position?

1

Standardwert

Count

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Sum

Zeigt die Summe der Werte der angegebenen Eigenschaften an.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Word

Zählt die Anzahl der Wörter im Eingabeobjekt.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.Management.Automation.PSObject

Sie können Objekte über die Pipeline an Measure-Object übergeben.

Ausgaben

GenericMeasureInfo oder TextMeasureInfoObject

Beispiel 1

C:\PS>get-childitem | measure-object

Beschreibung
-----------
Mit diesem Befehl werden die Dateien und Ordner im aktuellen Verzeichnis gezählt.






Beispiel 2

C:\PS>get-childitem | measure-object -property length -minimum -maximum -average

Beschreibung
-----------
Mit diesem Befehl wird die minimale Größe, die maximale Größe und die Gesamtgröße aller Dateien im aktuellen Verzeichnis sowie die Durchschnittsgröße der Dateien im Verzeichnis angezeigt.






Beispiel 3

C:\PS>get-content C:\test.txt | measure-object -character -line -word

Beschreibung
-----------
Mit diesem Befehl wird die Anzahl der Zeichen, Wörter und Zeilen in der Datei "Text.txt" angezeigt.






Beispiel 4

C:\PS>get-process | measure-object -property workingset -minimum -maximum -average

Beschreibung
-----------
Mit diesem Befehl werden die minimale, maximale und durchschnittliche Größe der Workingsets der Prozesse auf dem Computer angezeigt.






Beispiel 5

C:\PS>import-csv d:\test\serviceyrs.csv | measure-object -property years -minimum -maximum -average

Beschreibung
-----------
Mit diesem Befehl wird die durchschnittliche Anzahl der Dienstjahre der Mitarbeiter eines Unternehmens berechnet. 

Die Datei "ServiceYrs.csv" ist eine CSV-Datei, die die Mitarbeiternummer und Dienstjahre jedes Mitarbeiters enthält. Die erste Zeile in der Tabelle ist die Überschriftenzeile "EmpNo, Years".

Wenn Sie die Datei mithilfe von Import-Csv importieren, ist das Ergebnis ein PSCustomObject mit den Notizeigenschaften "EmpNo" und "Years". Sie können die Werte dieser Eigenschaften mithilfe von Measure-Object genauso wie jede andere Eigenschaft eines Objekts berechnen.






Beispiel 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

Beschreibung
-----------
In diesem Beispiel wird veranschaulicht, wie mit Measure-Object boolesche Werte gemessen werden. In diesem Fall wird die boolesche Eigenschaft "PSIsContainer" verwendet, um das Vorkommen von Ordnern (gegenüber Dateien) im aktuellen Verzeichnis zu messen.






Siehe auch




Inhaltsverzeichnis