Where-Object

Syntax

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     [-EQ]
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-FilterScript] <ScriptBlock>
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Match
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CEQ
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -GT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CGT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -LT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -GE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CGE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -LE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Like
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Contains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -In
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Is
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -IsNot
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     -Not
     [<CommonParameters>]

Description

O Where-Object cmdlet seleciona objetos que têm valores de propriedade específicos da coleção de objetos que lhe são transmitidos. Por exemplo, pode utilizar o Where-Object cmdlet para selecionar ficheiros que foram criados após uma determinada data, eventos com um ID específico ou computadores que utilizam uma versão específica do Windows.

A partir do Windows PowerShell 3.0, existem duas formas diferentes de construir um Where-Object comando.

• Bloco de scripts. Pode utilizar um bloco de scripts para especificar o nome da propriedade, um operador de comparação e um valor de propriedade. Where-Object devolve todos os objetos para os quais a instrução de bloco de script é verdadeira.

  Por exemplo, o seguinte comando obtém processos na Normal classe de prioridade, ou seja, processa em que o valor da propriedade PriorityClass é igual Normala .

  Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}

  Todos os operadores de comparação do PowerShell são válidos no formato de bloco de script. Para obter mais informações, veja about_Comparison_Operators.

• Instrução de comparação. Também pode escrever uma instrução de comparação, que é muito mais semelhante à linguagem natural. As instruções de comparação foram introduzidas no Windows PowerShell 3.0.

  Por exemplo, os seguintes comandos também obtêm processos que têm uma classe prioritária de Normal. Estes comandos são equivalentes e pode utilizá-los de forma intercambiável.

  Get-Process | Where-Object -Property PriorityClass -EQ -Value "Normal"

  Get-Process | Where-Object PriorityClass -EQ "Normal"

  A partir do Windows PowerShell 3.0, Where-Object adiciona operadores de comparação como parâmetros num Where-Object comando. A menos que seja especificado, todos os operadores não são sensíveis a maiúsculas e minúsculas. Antes Windows PowerShell 3.0, os operadores de comparação na linguagem do PowerShell só eram utilizáveis em blocos de script.

Quando fornece uma única Propriedade para Where-Object, o cmdlet trata o valor da propriedade como uma expressão booleana. Quando o valor do Comprimento da propriedade não é zero, a expressão é avaliada como $true. Por exemplo: ('hi', '', 'there') | Where-Object Length

O exemplo anterior é funcionalmente equivalente a:

• ('hi', '', 'there') | Where-Object Length -GT 0
• ('hi', '', 'there') | Where-Object { $_.Length -gt 0 }

Para obter mais informações sobre como o PowerShell avalia booleanos, veja about_Booleans.

Exemplos

Exemplo 1: Obter serviços parados

Estes comandos obtêm uma lista de todos os serviços que estão parados. A $_ variável automática representa cada objeto que é transmitido para o Where-Object cmdlet.

O primeiro comando utiliza o formato de bloco de script, o segundo comando utiliza o formato de instrução de comparação. Os comandos filtram os serviços da mesma forma e devolvem o mesmo resultado. Apenas a sintaxe é diferente.

Get-Service | Where-Object { $_.Status -eq "Stopped" }
Get-Service | Where-Object Status -EQ "Stopped"

Exemplo 2: Obter processos com base no conjunto de trabalho

Estes comandos listam processos que têm um conjunto de trabalho superior a 250 megabytes (MB). Os comandos filtram os processos da mesma forma e devolvem o mesmo resultado. Apenas a sintaxe é diferente.

Get-Process | Where-Object { $_.WorkingSet -GT 250MB }
Get-Process | Where-Object WorkingSet -GT 250MB

Exemplo 3: Obter processos com base no nome do processo

Estes comandos obtêm os processos que têm um valor de propriedade ProcessName que começa com a letra p. O operador Match permite-lhe utilizar correspondências de expressão regulares.

Os comandos filtram os processos da mesma forma e devolvem o mesmo resultado. Apenas a sintaxe é diferente.

Get-Process | Where-Object { $_.ProcessName -Match "^p.*" }
Get-Process | Where-Object ProcessName -Match "^p.*"

Exemplo 4: utilizar o formato de instrução de comparação

Este exemplo mostra como utilizar o novo formato de instrução de comparação do Where-Object cmdlet.

O primeiro comando utiliza o formato de instrução de comparação. Não utiliza quaisquer aliases e inclui o nome para cada parâmetro.

O segundo comando é a utilização mais natural do formato de comando de comparação. O comando substitui o alias where pelo nome do Where-Object cmdlet e omite todos os nomes de parâmetros opcionais.

Os comandos filtram os processos da mesma forma e devolvem o mesmo resultado. Apenas a sintaxe é diferente.

Get-Process | Where-Object -Property Handles -GE -Value 1000
Get-Process | where Handles -GE 1000

Exemplo 5: Obter comandos baseados em propriedades

Este exemplo mostra como escrever comandos que devolvem itens verdadeiros ou falsos ou que têm qualquer valor para uma propriedade especificada. Cada exemplo mostra os formatos de bloco de script e de instrução de comparação para o comando.

Os comandos filtram a respetiva entrada da mesma forma e devolvem o mesmo resultado. Apenas a sintaxe é diferente.

# Use Where-Object to get commands that have any value for the OutputType
# property of the command. This omits commands that do not have an OutputType
# property and those that have an OutputType property, but no property value.
Get-Command | Where-Object OutputType
Get-Command | Where-Object { $_.OutputType }

# Use Where-Object to get objects that are containers. This gets objects that
# have the **PSIsContainer** property with a value of $True and excludes all
# others.
Get-ChildItem | Where-Object PSIsContainer
Get-ChildItem | Where-Object { $_.PSIsContainer }

# Finally, use the -not operator (!) to get objects that are not containers.
# This gets objects that do have the **PSIsContainer** property and those
# that have a value of $False for the **PSIsContainer** property.
Get-ChildItem | Where-Object -Not PSIsContainer
Get-ChildItem | Where-Object { !$_.PSIsContainer }

Exemplo 6: Utilizar várias condições

Get-Module -ListAvailable | Where-Object {
    ($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri
}

Este exemplo mostra como criar um Where-Object comando com múltiplas condições.

Este comando obtém módulos não essenciais que suportam a funcionalidade Ajuda Atualizável. O comando utiliza o parâmetro ListAvailable do Get-Module cmdlet para obter todos os módulos no computador. Um operador de pipeline (|) envia os módulos para o Where-Object cmdlet, que obtém módulos cujos nomes não começam por Microsoft ou PS, e têm um valor para a propriedade HelpInfoURI , que indica ao PowerShell onde encontrar ficheiros de ajuda atualizados para o módulo. O -and operador lógico liga as instruções de comparação.

O exemplo utiliza o formato de comando de bloco de script. Os operadores lógicos, como -and,-or e -not só são válidos em blocos de script. Não pode utilizá-los no formato de instrução de comparação de um Where-Object comando.

• Para obter mais informações sobre operadores lógicos do PowerShell, veja about_Logical_Operators.
• Para obter mais informações sobre a funcionalidade Ajuda Atualizável, consulte about_Updatable_Help.

Parâmetros

-CContains

-CEQ

-CGE

-CGT

-CIn

-CLE

-CLike

-CLT

-CMatch

-CNE

-CNotContains

-CNotIn

-CNotLike

-CNotMatch

-Contains

-EQ

-FilterScript

-GE

-GT

-In

-InputObject

-Is

-IsNot

-LE

-Like

-LT

-Match

-NE

-Not

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

Entradas

PSObject

Pode encaminhar qualquer objeto para este cmdlet.

Saídas

Object

Este cmdlet devolve os itens selecionados do conjunto de objetos de entrada.

Notas

O PowerShell inclui os seguintes aliases para Where-Object:

• Todas as Plataformas:
  • ?
  • where

A partir da Windows PowerShell 4.0 e WhereForEach foram adicionados métodos para utilização com coleções.

Pode ler mais sobre estes métodos aqui about_arrays

Ligações Relacionadas

• Compare-Object
• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Sort-Object
• Tee-Object
• about_Booleans