Calcola le proprietà numeriche degli oggetti e i caratteri, le parole e le righe degli oggetti stringa, ad esempio i file di testo.

Sintassi

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

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

Descrizione

Il cmdlet Measure-Object calcola i valori della proprietà di determinati tipi di oggetti. Measure-Object esegue tre tipi di misurazioni, a seconda dei parametri nel comando.

Il cmdlet Measure-Object esegue calcoli sui valori delle proprietà degli oggetti. Può contare gli oggetti e calcolare il valore minimo e massimo, la somma e la media dei valori numerici. Per gli oggetti di testo, può contare e calcolare il numero di righe, parole e caratteri.

Parametri

-Average

Visualizza il valore medio delle proprietà specificate.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Character

Conta il numero di caratteri inclusi nell'oggetto di input.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-IgnoreWhiteSpace

Ignora lo spazio nei conteggi di parole e caratteri. Per impostazione predefinita, lo spazio non viene ignorato.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-InputObject <psobject>

Specifica gli oggetti da misurare. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-Line

Conta il numero di righe incluse nell'oggetto di input.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Maximum

Visualizza il valore massimo delle proprietà specificate.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Minimum

Visualizza il valore minimo delle proprietà specificate.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Property <string[]>

Specifica una o più proprietà numeriche da misurare. L'impostazione predefinita è la proprietà Count (Length) dell'oggetto.

Obbligatorio?

false

Posizione?

1

Valore predefinito

Count

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Sum

Visualizza la somma dei valori delle proprietà specificate.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Word

Conta il numero di parole incluse nell'oggetto di input.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.Management.Automation.PSObject

È possibile reindirizzare oggetti a Measure-Object.

Output

GenericMeasureInfo o TextMeasureInfoObject

Esempio 1

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

Descrizione
-----------
Con questo comando vengono contati i file e le cartelle presenti nella directory corrente.

Esempio 2

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

Descrizione
-----------
Con questo comando vengono visualizzati il valore minimo e massimo e la somma delle dimensioni di tutti i file inclusi nella directory corrente, nonché le dimensioni medie di un file incluso nella directory.

Esempio 3

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

Descrizione
-----------
Tramite questo comando verrà visualizzato il numero di caratteri, parole e righe inclusi nel file Text.txt.

Esempio 4

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

Descrizione
-----------
Con questo comando vengono visualizzate le dimensioni minime, massime e medie dei working set dei processi nel computer.

Esempio 5

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

Descrizione
-----------
Questo comando calcola gli anni medi di servizio dei dipendenti di una società. 

Il file ServiceYrs.csv è un file CSV che contiene il numero di dipendenti e gli anni di servizio di ciascun dipendente. La prima riga nella tabella è una riga di intestazione di "EmpNo, Years".

Quando si utilizza Import-Csv per importare il file, il risultato è un oggetto PSCustomObject con proprietà nota di EmpNo e Years. È possibile utilizzare Measure-Object per calcolare i valori di queste proprietà, come qualsiasi altra proprietà di un oggetto.

Esempio 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

Descrizione
-----------
In questo esempio viene illustrato che Measure-Object può misurare valori booleani. In questo caso, utilizza la proprietà booleana PSIsContainer per misurare l'incidenza delle cartelle (rispetto ai file) nella directory corrente.

Vedere anche



Argomenti della Guida