Measure-Object

Calcula las propiedades numéricas de los objetos así como los caracteres, palabras y líneas en los objetos de cadena, como archivos de texto.

Sintaxis

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

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

Descripción

El cmdlet Measure-Object calcula los valores de propiedad de determinados tipos de objetos. Measure-Object realiza tres tipos de mediciones, según los parámetros del comando.

El cmdlet Measure-Object realiza cálculos con los valores de propiedad de los objetos. Puede contar objetos y calcular el mínimo, el máximo, la suma y el promedio de los valores numéricos. En el caso de los objetos de texto, puede contar y calcular el número de líneas, palabras y caracteres.

Parámetros

-Average

Muestra el promedio de las propiedades especificadas.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Character

Cuenta el número de caracteres del objeto de entrada.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-IgnoreWhiteSpace

Omite los espacios en blanco al contar el número de palabras y caracteres. De forma predetermina, se tienen en cuenta los espacios en blanco.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-InputObject <psobject>

Especifica los objetos que se van a medir. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByValue)
¿Aceptar caracteres comodín?	false

-Line

Cuenta el número de líneas del objeto de entrada.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Maximum

Muestra el valor máximo de las propiedades especificadas.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Minimum

Muestra el valor mínimo de las propiedades especificadas.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Property <string[]>

Especifica una o varias propiedades numéricas que se van a medir. El valor predeterminado es la propiedad Count (Length) del objeto.

¿Requerido?	false
¿Posición?	1
Valor predeterminado	Count
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Sum

Muestra la suma de los valores de las propiedades especificadas.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Word

Cuenta el número de palabras en el objeto de entrada.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	System.Management.Automation.PSObject Puede canalizar objetos a Measure-Object.
Salidas	GenericMeasureInfo o TextMeasureInfoObject

Ejemplo 1

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

Descripción
-----------
Este comando cuenta los archivos y carpetas del directorio actual.

Ejemplo 2

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

Descripción
-----------
Este comando muestra el tamaño mínimo, el tamaño máximo y la suma de los tamaños de todos los archivos ubicados en el directorio actual, así como el tamaño de archivo medio del directorio.

Ejemplo 3

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

Descripción
-----------
Este comando muestra el número de caracteres, palabras y líneas del archivo Text.txt.

Ejemplo 4

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

Descripción
-----------
Este comando muestra el tamaño mínimo, el tamaño máximo y el tamaño medio de los conjuntos de trabajo de los procesos en el equipo.

Ejemplo 5

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

Descripción
-----------
Este comando calcula el promedio de los años de servicio de los empleados de una compañía. 

El archivo ServiceYrs.csv es un archivo CSV que contiene el número de empleados y los años de servicio de cada empleado. La primera fila de la tabla es la fila de encabezado "EmpNo, Years".

Cuando se usa Import-Csv para importar el archivo, el resultado es un objeto PSCustomObject con EmpNo y Years como propiedades Note. Se puede utilizar Measure-Object para calcular los valores de estas propiedades, al igual que cualquier otra propiedad de un objeto.

Ejemplo 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

Descripción
-----------
En este ejemplo, se muestra que Measure-Object puede medir valores booleanos. En este caso, se utiliza la propiedad booleana PSIsContainer para medir la incidencia de carpetas (con respecto a archivos) en el directorio actual.

Vea también

Conceptos

Compare-Object
ForEach-Object
Group-Object
New-Object
Select-Object
Sort-Object
Tee-Object
Where-Object