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