Measure-Object
Calcula as propriedades numéricas de objetos e os caracteres, palavras e linhas em objetos de string, 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.