Where-Object

Sintaxe

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>]
     [-LE]
     [<CommonParameters>]

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

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

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

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     [-GE]
     [<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>]
     [-Match]
     [<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>]
     [-Like]
     [<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>
     [[-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>]

Description

O cmdlet Where-Object seleciona objetos que têm valores de propriedade específicos da coleção de objetos que são passados para ele. Por exemplo, você pode usar o cmdlet Where-Object para selecionar arquivos que foram criados após uma determinada data, eventos com uma ID específica ou computadores que usam uma versão específica do Windows.

A partir do Windows PowerShell 3.0, há duas maneiras diferentes de construir um comando Where-Object.

• do bloco script . Você pode usar um bloco de script para especificar o nome da propriedade, um operador de comparação e um valor de propriedade. Where-Object retorna todos os objetos para os quais a instrução de bloco de script é verdadeira.

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

  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 sobre operadores de comparação, consulte about_Comparison_Operators.

• instrução Comparison. Você também pode escrever uma instrução de comparação, que é muito mais parecida com a linguagem natural. Instruções de comparação foram introduzidas no Windows PowerShell 3.0.

  Por exemplo, os comandos a seguir também obtêm processos que têm uma classe de prioridade normal. Esses comandos são equivalentes e podem ser usados 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 em um comando Where-Object. A menos que especificado, todos os operadores não diferenciam maiúsculas de minúsculas. Antes do Windows PowerShell 3.0, os operadores de comparação no idioma do PowerShell só podiam ser usados em blocos de script.

Exemplos

Exemplo 1: Obter serviços interrompidos

Esses comandos obtêm uma lista de todos os serviços que estão parados no momento.

A variável $_ automática representa cada objeto passado para o cmdlet Where-Object.

O primeiro comando usa o formato de bloco de script, o segundo comando usa o formato de instrução de comparação.

Os comandos são equivalentes e podem ser usados de forma intercambiável.

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

Exemplo 2: Obter processos com base no conjunto de trabalho

Esses comandos listam processos que têm um conjunto de trabalho maior que 25.000 quilobytes (KB). Como o valor da propriedade WorkingSet é armazenado em bytes, o valor de 25.000 é multiplicado por 1.024.

O scriptblock e a sintaxe de instrução são equivalentes e podem ser usados de forma intercambiável.

Get-Process | Where-Object {$_.WorkingSet -GT 25000*1024}
Get-Process | Where-Object WorkingSet -GT (25000*1024)

Exemplo 3: Obter processos com base no nome do processo

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

O scriptblock e a sintaxe de instrução são equivalentes e podem ser usados de forma intercambiável.

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

Exemplo 4: Usar o formato da instrução de comparação

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

O primeiro comando usa o formato de instrução de comparação. Nesse comando, nenhum aliases é usado e todos os parâmetros incluem o nome do parâmetro.

O segundo comando é o uso mais natural do formato de comando de comparação. A em que alias é substituído pelo nome do cmdlet Where-Object e todos os nomes de parâmetro opcionais são omitidos.

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

Exemplo 5: Obter comandos com base nas propriedades

Este exemplo mostra como gravar comandos que retornam 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.

# 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 OutputType
Get-Command | where {$_.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 PSIsContainer
Get-ChildItem | where {$_.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 {!$_.PSIsContainer}
# You cannot use the Not operator (!) in the comparison statement format of the command.
Get-ChildItem | where PSIsContainer -eq $False

Exemplo 6: Usar várias condições

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

Este exemplo mostra como criar um comando Where-Object com várias condições.

Esse comando obtém módulos não essenciais que dão suporte ao recurso ajuda atualizável. O comando usa o parâmetro ListAvailable do cmdlet Get-Module para obter todos os módulos no computador. Um operador de pipeline (|) envia os módulos para o cmdlet Where-Object, que obtém módulos cujos nomes não começam com a Microsoft ou PS e têm um valor para a propriedade HelpInfoURI, que informa ao PowerShell onde encontrar arquivos de ajuda atualizados para o módulo. As instruções de comparação são conectadas pelo operador lógico e.

O exemplo usa o formato de comando de bloco de script. Operadores lógicos, como e e ou, são válidos apenas em blocos de script. Você não pode usá-los no formato de instrução de comparação de um comando Where-Object.

• Para obter mais informações sobre operadores lógicos do PowerShell, consulte about_Logical_Operators.
• Para obter mais informações sobre o recurso 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

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

Entradas

PSObject

Você pode canalizar os objetos para este cmdlet.

Saídas

Object

Esse cmdlet retorna itens selecionados do conjunto de objetos de entrada.

Observações

• A partir do Windows PowerShell 4.0, métodos Where e ForEach foram adicionados para uso com coleções.
  • Você pode ler mais sobre esses novos métodos aqui about_arrays

Links Relacionados

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