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