Calcule les propriétés numériques des objets, ainsi que les caractères, mots et lignes des objets chaînes, tels que les fichiers de texte.

Syntaxe

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

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

Description

L'applet de commande Measure-Object calcule les valeurs de propriété de certains types d'objets. Measure-Object exécute trois types de mesures, selon les paramètres de la commande.

L'applet de commande Measure-Object effectue les calculs sur les valeurs de propriété des objets. Elle peut compter des objets et calculer le minimum, le maximum, la somme et la moyenne des valeurs numériques. Pour les objets texte, elle peut compter et calculer le nombre des lignes, de mots et de caractères.

Paramètres

-Average

Affiche la valeur moyenne des propriétés spécifiées.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Character

Compte le nombre de caractères dans l'objet d'entrée.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-IgnoreWhiteSpace

Ignore l'espace blanc dans les décomptes de mots et les nombres de caractères. Par défaut, l'espace blanc n'est pas ignoré.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InputObject <psobject>

Spécifie les objets à mesurer. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces objets.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-Line

Compte le nombre de lignes dans l'objet d'entrée.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Maximum

Affiche la valeur maximale des propriétés spécifiées.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Minimum

Affiche la valeur minimale des propriétés spécifiées.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Property <string[]>

Spécifie une ou plusieurs propriétés numériques à mesurer. La valeur par défaut est la propriété Count (Length) de l'objet.

Obligatoire ?

false

Position ?

1

Valeur par défaut

Count

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Sum

Affiche la somme des valeurs des propriétés spécifiées.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Word

Compte le nombre de mots dans l'objet d'entrée.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.Management.Automation.PSObject

Vous pouvez diriger des objets vers Measure-Object.

Sorties

GenericMeasureInfo ou TextMeasureInfoObject

Exemple 1

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

Description
-----------
Cette commande compte les fichiers et dossiers du répertoire actif.






Exemple 2

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

Description
-----------
Cette commande affiche le minimum, le maximum et la somme des tailles de tous les fichiers du répertoire actif, ainsi que la taille moyenne de ces fichiers.






Exemple 3

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

Description
-----------
Cette commande affiche le nombre des caractères, de mots et de lignes dans le fichier Text.txt.






Exemple 4

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

Description
-----------
Cette commande affiche les tailles minimales, maximales et moyennes des plages de travail des processus de l'ordinateur.






Exemple 5

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

Description
-----------
Cette commande calcule la moyenne des années de service des employés d'une société. 

Le fichier ServiceYrs.csv est un fichier CSV qui contient le numéro d'employé et les années de service de chaque employé. La première ligne de la table est la ligne d'en-tête « EmpNo, Years ».

Lorsque vous utilisez Import-Csv pour importer le fichier, le résultat obtenu est un objet PSCustomObject possédant les propriétés de note EmpNo et Years. Vous pouvez utiliser Measure-Object pour calculer les valeurs de ces propriétés, tout comme vous le feriez avec les autres propriétés d'un objet.






Exemple 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

Description
-----------
Cet exemple montre que Measure-Object peut mesurer des valeurs booléennes. Dans ce cas, elle utilise la propriété booléenne PSIsContainer pour mesurer la fréquence des dossiers (par rapport aux fichiers) dans le répertoire actif.






Voir aussi




Table des matières