Measure-Object

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Calcula as propriedades numéricas de objetos e os caracteres, palavras e linhas em objetos de cadeia de caracteres, como arquivos de texto.

Syntax

Measure-Object
       [-InputObject <PSObject>]
       [[-Property] <String[]>]
       [-Sum]
       [-Average]
       [-Maximum]
       [-Minimum]
       [<CommonParameters>]
Measure-Object
       [-InputObject <PSObject>]
       [[-Property] <String[]>]
       [-Line]
       [-Word]
       [-Character]
       [-IgnoreWhiteSpace]
       [<CommonParameters>]

Description

O Measure-Object cmdlet 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 Measure-Object cmdlet executa cálculos nos valores de propriedade dos objetos. Você pode usar Measure-Object para contar objetos ou contar objetos com uma Propriedade especificada. Você também 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

Esse comando conta os arquivos e pastas no diretório atual.

Get-ChildItem | Measure-Object

Exemplo 2: Medir os arquivos em um diretório

Esse comando exibe o Mínimo, o Máximo e a 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 gera a saída do 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 System.Diagnostics.Process não tem uma propriedade DisplayName e é deixado de fora da contagem final.

$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 os médio anos de serviço dos funcionários de uma empresa.

O ServiceYrs.csv arquivo é um arquivo CSV que contém o número de funcionários e os anos de serviço de cada funcionário. A primeira linha na 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 Boolean PSIsContainerpara 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 `n de nova linha separa as 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 de cada objeto de entrada, bem como entre objetos de entrada. Consulte o Exemplo 7.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica os objetos a serem medidos. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém os objetos.

Quando você usa o parâmetro InputObject com Measure-Object, em vez de canalizar resultados de 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.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 de cada objeto de entrada, bem como entre objetos de entrada. Consulte o Exemplo 7.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Maximum

Indica que o cmdlet exibe o valor máximo das propriedades especificadas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Minimum

Indica que o cmdlet exibe o valor mínimo das propriedades especificadas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Property

Especifica uma ou mais propriedades a serem medidas. Se você não especificar nenhuma outra medida, Measure-Object contará os objetos que têm as propriedades especificadas.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Sum

Indica que o cmdlet exibe a soma dos valores das propriedades especificadas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 de cada objeto de entrada, bem como entre objetos de entrada. Consulte o Exemplo 7.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSObject

Você pode canalizar objetos para esse 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 .

Observações

O Windows PowerShell inclui os seguintes aliases para Measure-Object:

  • measure