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

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

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

Descrição

O cmdlet Measure-Object calcula os valores de propriedade de certos tipos de objeto. Measure-Object executa três tipos de medições, dependendo dos parâmetros no comando.

O cmdlet Measure-Object realiza cálculos nos valores de propriedade de objetos. Ele pode contar objetos e pode calcular o mínimo, ó máximo, a soma e a média dos valores numéricos. Para objetos de texto, ele pode contar e calcular o número de linhas, palavras e caracteres.

Parâmetros

-Average

Exibe o valor médio de propriedades especificadas.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Character

Conta o número de caracteres no objeto de entrada.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-IgnoreWhiteSpace

Ignora os espaços em branco nas contagens de palavras e de caracteres. Por padrão, o espaço em branco não é ignorado.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InputObject <psobject>

Especifica os objetos a serem medidos. Insira uma variável que contenha os objetos, ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Line

Conta o número de linhas no objeto de entrada.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Maximum

Exibe o valor máximo de propriedades especificadas.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Minimum

Exibe o valor mínimo de propriedades especificadas.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Property <string[]>

Especifica uma ou mais propriedades numéricas a serem medidas. O padrão é a propriedade Count (Length) do objeto.

Necessário?	false
Posição?	1
Valor padrão	Count
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Sum

Exibe a soma dos valores de propriedades especificadas.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Word

Conta o número de palavras no objeto de entrada.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	System.Management.Automation.PSObject É possível canalizar objetos para Measure-Object.
Saídas	GenericMeasureInfo ou TextMeasureInfoObject

Exemplo 1

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

Descrição
-----------
Este comando conta os arquivos e pastas do diretório atual.

Exemplo 2

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

Descrição
-----------
Esse comando exibe os tamanhos mínimo e máximo e a soma de todos os arquivos no diretório atual, bem como o tamanho médio de um arquivo no diretório.

Exemplo 3

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

Descrição
-----------
Esse comando exibe o número de caracteres, palavras e linhas no arquivo Text.txt.

Exemplo 4

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

Descrição
-----------
Este comando exibe os tamanhos mínimo, o máximo e médio dos conjuntos de trabalho dos processos no computador.

Exemplo 5

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

Descrição
-----------
Este comando calcula a média de anos de serviço dos funcionários de uma empresa. 

O arquivo ServiceYrs.csv é um arquivo CSV que contém o número de funcionário e anos de serviço de cada funcionário. A primeira linha da tabela é uma linha de cabeçalho "EmpNo, Years."

Quando você usa Import-Csv para importar o arquivo, o resultado é um PSCustomObject com propriedades de observação de EmpNo e Years. Você pode usar Measure-Object para calcular os valores destas propriedades, como qualquer outra propriedade de um objeto.

Exemplo 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

Descrição
-----------
Esse exemplo demonstra que Measure-Object pode medir valores Booleanos. Nesse caso, ele usa a propriedade PSIsContainer Booleano para medir a incidência de pastas (versus arquivos) no diretório atual.

Consulte também

Conceitos

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