Measure-Object
Calcula as propriedades numéricas de objetos e os caracteres, palavras e linhas em objetos de cadeia de caracteres, como arquivos de texto.
Sintaxe
GenericMeasure (Predefinição)
Measure-Object
[[-Property] <String[]>]
[-InputObject <PSObject>]
[-Sum]
[-Average]
[-Maximum]
[-Minimum]
[<CommonParameters>]
TextMeasure
Measure-Object
[[-Property] <String[]>]
[-InputObject <PSObject>]
[-Line]
[-Word]
[-Character]
[-IgnoreWhiteSpace]
[<CommonParameters>]
Description
O cmdlet Measure-Object calcula os valores de propriedade de determinados tipos de objeto.
Measure-Object executa três tipos de medições, dependendo dos parâmetros no comando.
O cmdlet Measure-Object executa cálculos nos valores de propriedade de objetos. Você pode usar Measure-Object para calcular o Mínimo, Máximo, Soma, Desvio Padrão e Média de valores numéricos. Para objetos String, você também pode usar Measure-Object para contar o número de linhas, palavras e caracteres.
Exemplos
Exemplo 1: Contar os arquivos e pastas em um diretório
Este comando conta os arquivos e pastas no diretório atual.
Get-ChildItem | Measure-Object
Exemplo 2: Medir os arquivos em um diretório
Este comando exibe o Mínimo, Máximo e Soma dos tamanhos de todos os arquivos no diretório atual e o tamanho médio de um arquivo no diretório.
Get-ChildItem | Measure-Object -Property Length -Minimum -Maximum -Sum -Average
Exemplo 3: Medir texto em um arquivo de texto
Este comando exibe o número de caracteres, palavras e linhas no arquivo Text.txt.
Sem o parâmetro Raw, Get-Content produz o arquivo como uma matriz de linhas.
O primeiro comando usa Set-Content para adicionar algum texto padrão a um arquivo.
"One", "Two", "Three", "Four" | Set-Content -Path C:\Temp\tmp.txt
Get-Content C:\Temp\tmp.txt | Measure-Object -Character -Line -Word
Lines Words Characters Property
----- ----- ---------- --------
4 4 15
Exemplo 4: Medir objetos que contêm uma propriedade especificada
Este exemplo conta o número de objetos que têm uma propriedade DisplayName. Os dois primeiros comandos recuperam todos os serviços e processos na máquina local. O terceiro comando conta o número combinado de serviços e processos. O último comando combina as duas coleções e canaliza o resultado para Measure-Object.
O objeto
$services = Get-Service
$processes = Get-Process
$services + $processes | Measure-Object
$services + $processes | Measure-Object -Property DisplayName
Count : 682
Average :
Sum :
Maximum :
Minimum :
Property :
Count : 290
Average :
Sum :
Maximum :
Minimum :
Property : DisplayName
Exemplo 5: Medir o conteúdo de um arquivo CSV
Este comando calcula a média de anos de serviço dos colaboradores de uma empresa.
O arquivo ServiceYrs.csv é um arquivo CSV que contém o número de funcionário e os anos de serviço de cada funcionário. A primeira linha da tabela é uma linha de cabeçalho de EmpNo, Years.
Quando você usa Import-Csv para importar o arquivo, o resultado é um PSCustomObject com propriedades de nota de EmpNo e Years.
Você pode usar Measure-Object para calcular os valores dessas propriedades, assim como qualquer outra propriedade de um objeto.
Import-Csv D:\test\serviceyrs.csv | Measure-Object -Property Years -Minimum -Maximum -Average
Exemplo 6: Medir valores booleanos
Este exemplo demonstra como o Measure-Object pode medir valores booleanos.
Nesse caso, ele usa a propriedade PSIsContainerBoolean para medir a incidência de pastas (vs. arquivos) no diretório atual.
Get-ChildItem | Measure-Object -Property PSIsContainer -Maximum -Sum -Minimum -Average
Count : 126
Average : 0.0634920634920635
Sum : 8
Maximum : 1
Minimum : 0
StandardDeviation :
Property : PSIsContainer
Exemplo 7: Medir cadeias de caracteres
O exemplo a seguir mede o número de linhas, primeiro uma única cadeia de caracteres e, em seguida, em várias cadeias de caracteres. O caractere de nova linha `n separa cadeias de caracteres em várias linhas.
# The newline character `n separates the string into separate lines, as shown in the output.
"One`nTwo`nThree"
"One`nTwo`nThree" | Measure-Object -Line
One
Two
Three
Lines Words Characters Property
----- ----- ---------- --------
3
# The first string counts as a single line.
# The second string is separated into two lines by the newline character.
"One", "Two`nThree" | Measure-Object -Line
Lines Words Characters Property
----- ----- ---------- --------
3
# The Word switch counts the number of words in each InputObject
# Each InputObject is treated as a single line.
"One, Two", "Three", "Four Five" | Measure-Object -Word -Line
Lines Words Characters Property
----- ----- ---------- --------
3 5
Parâmetros
-Average
Indica que o cmdlet exibe o valor médio das propriedades especificadas.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GenericMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Character
Indica que o cmdlet conta o número de caracteres nos objetos de entrada.
Observação
As opções Word, Char e Line contam dentro cada objeto de entrada, bem como em objetos de entrada. Ver Exemplo 7.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
TextMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-IgnoreWhiteSpace
Indica que o cmdlet ignora o espaço em branco nas contagens de caracteres. Por padrão, o espaço em branco não é ignorado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
TextMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica os objetos a serem medidos. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.
Quando você usa o parâmetro InputObject com Measure-Object, em vez de canalizar os resultados do comando para Measure-Object, o valor InputObject é tratado como um único objeto.
É recomendável usar Measure-Object no pipeline se quiser medir uma coleção de objetos com base em se os objetos têm valores específicos em propriedades definidas.
Propriedades dos parâmetros
| Tipo: | PSObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Line
Indica que o cmdlet conta o número de linhas nos objetos de entrada.
Observação
As opções Word, Char e Line contam dentro cada objeto de entrada, bem como em objetos de entrada. Ver Exemplo 7.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
TextMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Maximum
Indica que o cmdlet exibe o valor máximo das propriedades especificadas.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GenericMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Minimum
Indica que o cmdlet exibe o valor mínimo das propriedades especificadas.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GenericMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Property
Especifica uma ou mais propriedades a serem medidas. Se você não especificar outras medidas, Measure-Object contará os objetos que têm as propriedades especificadas.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Sum
Indica que o cmdlet exibe a soma dos valores das propriedades especificadas.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GenericMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Word
Indica que o cmdlet conta o número de palavras nos objetos de entrada.
Observação
As opções Word, Char e Line contam dentro cada objeto de entrada, bem como em objetos de entrada. Ver Exemplo 7.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
TextMeasure
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSObject
Você pode canalizar objetos para este cmdlet.
Saídas
GenericMeasureInfo
Por padrão, esse cmdlet retorna um objeto GenericMeasureInfo.
TextMeasureInfo
Quando você usa o parâmetro Word, esse cmdlet retorna um objeto TextMeasureInfo.
Notas
O Windows PowerShell inclui os seguintes aliases para Measure-Object:
measure
