Where-Object

Sintaxe

EqualSet (Predefinição)

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

ScriptBlockSet

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

MatchSet

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

CaseSensitiveEqualSet

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

NotEqualSet

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

CaseSensitiveNotEqualSet

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

GreaterThanSet

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

CaseSensitiveGreaterThanSet

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

LessThanSet

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

CaseSensitiveLessThanSet

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

GreaterOrEqualSet

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

CaseSensitiveGreaterOrEqualSet

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

LessOrEqualSet

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

CaseSensitiveLessOrEqualSet

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

LikeSet

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

CaseSensitiveLikeSet

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

NotLikeSet

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

CaseSensitiveNotLikeSet

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

CaseSensitiveMatchSet

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

NotMatchSet

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

CaseSensitiveNotMatchSet

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

ContainsSet

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

CaseSensitiveContainsSet

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

NotContainsSet

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

CaseSensitiveNotContainsSet

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

InSet

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

CaseSensitiveInSet

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

NotInSet

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

CaseSensitiveNotInSet

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

IsSet

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

IsNotSet

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

Not

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

Description

Exemplos

Exemplo 1: Obter serviços interrompidos

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

Exemplo 2: Obter processos com base no conjunto de trabalho

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

Exemplo 3: Obter processos com base no nome do processo

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

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

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

Exemplo 5: Obter comandos com base nas propriedades

# 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: Usar várias condições

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

Parâmetros

-CContains

Indica que esse cmdlet obtém objetos de uma coleção se o valor da propriedade do objeto for uma correspondência exata para o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains refere-se a uma coleção de valores e é true se a coleção contém um item que é uma correspondência exata para o valor especificado. Se a entrada for um único objeto, o PowerShell a converterá em uma coleção de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CEQ

Indica que esse cmdlet obtém objetos se o valor da propriedade for igual ao valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CGE

Indica que esse cmdlet obtém objetos se o valor da propriedade for maior ou igual ao valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CGT

Indica que esse cmdlet obtém objetos se o valor da propriedade for maior que o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CIn

Indica que esse cmdlet obtém objetos se o valor da propriedade incluir o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object -Value "svchost" -CIn ProcessName

CIn se assemelha CContains , exceto que as posições de propriedade e valor são invertidas. Por exemplo, as seguintes afirmações são verdadeiras.

"abc", "def" -CContains "abc"

"abc" -CIn "abc", "def"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CLE

Indica que esse cmdlet obtém objetos se o valor da propriedade for menor ou igual ao valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CLike

Indica que esse cmdlet obtém objetos se o valor da propriedade corresponder a um valor que inclua caracteres curinga (*). Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object ProcessName -CLike "*host"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CLT

Indica que esse cmdlet obtém objetos se o valor da propriedade for menor que o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CMatch

Indica que esse cmdlet obtém objetos se o valor da propriedade corresponder à expressão regular especificada. Esta operação diferencia maiúsculas de minúsculas. Quando a entrada é um único objeto, o valor correspondente é salvo na variável automática $Matches.

Por exemplo: Get-Process | Where-Object ProcessName -CMatch "Shell"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CNE

Indica que esse cmdlet obtém objetos se o valor da propriedade for diferente do valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CNotContains

Indica que esse cmdlet obtém objetos se o valor da propriedade do objeto não for uma correspondência exata para o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains e CNotContains referem-se a uma coleção de valores e são true quando a coleção não contém nenhum item que seja uma correspondência exata para o valor especificado. Se a entrada for um único objeto, o PowerShell a converterá em uma coleção de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CNotIn

Indica que esse cmdlet obtém objetos se o valor da propriedade não for uma correspondência exata para o valor especificado. Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName

Os operadores NotIn e CNotIn se assemelham a NotContains e CNotContains, exceto que as posições de propriedade e valor são invertidas. Por exemplo, as seguintes afirmações são verdadeiras.

"abc", "def" -CNotContains "Abc"

"abc" -CNotIn "Abc", "def"

Propriedades dos parâmetros

Conjuntos de parâmetros

-CNotLike

Indica que esse cmdlet obtém objetos se o valor da propriedade não corresponder a um valor que inclua caracteres curinga. Esta operação diferencia maiúsculas de minúsculas.

Por exemplo: Get-Process | Where-Object ProcessName -CNotLike "*host"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CNotMatch

Indica que esse cmdlet obtém objetos se o valor da propriedade não corresponder à expressão regular especificada. Esta operação diferencia maiúsculas de minúsculas. Quando a entrada é um único objeto, o valor correspondente é salvo na variável automática $Matches.

Por exemplo: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Contains

Indica que esse cmdlet obtém objetos se qualquer item no valor da propriedade do objeto for uma correspondência exata para o valor especificado.

Por exemplo: Get-Process | Where-Object ProcessName -Contains "Svchost"

Se a entrada for um único objeto, o PowerShell a converterá em uma coleção de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EQ

Indica que esse cmdlet obtém objetos se o valor da propriedade for igual ao valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-FilterScript

Especifica o bloco de script usado para filtrar os objetos. Coloque o bloco de script entre chaves ({}).

O nome do parâmetro, FilterScript, é opcional.

Propriedades dos parâmetros

Conjuntos de parâmetros

-GE

Indica que esse cmdlet obtém objetos se o valor da propriedade for maior ou igual ao valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-GT

Indica que esse cmdlet obtém objetos se o valor da propriedade for maior que o valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-In

Indica que esse cmdlet obtém objetos se o valor da propriedade corresponder a qualquer um dos valores especificados. Por exemplo:

Get-Process | Where-Object -Property ProcessName -In -Value "Svchost", "TaskHost", "WsmProvHost"

Se a entrada for um único objeto, o PowerShell a converterá em uma coleção de um objeto.

Se o valor da propriedade de um objeto for uma matriz, o PowerShell usará a igualdade de referência para determinar uma correspondência. Where-Object retorna o objeto somente se o valor do parâmetro Property e qualquer valor de Value forem a mesma instância de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-InputObject

Especifica os objetos a serem filtrados. Você também pode canalizar os objetos para Where-Object.

Quando você usa o parâmetro InputObject com Where-Object, em vez de canalizar os resultados do comando para Where-Object, o cmdlet trata o InputObject como um único objeto. Isso é verdadeiro mesmo se o valor for uma coleção que é o resultado de um comando, como -InputObject (Get-Process).

Como InputObject não pode retornar propriedades individuais de uma matriz ou coleção de objetos, recomendamos que, se você usar Where-Object para filtrar uma coleção de objetos para esses objetos que têm valores específicos em propriedades definidas, use Where-Object no pipeline, conforme mostrado nos exemplos deste tópico.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Is

Indica que esse cmdlet obtém objetos se o valor da propriedade for uma instância do tipo .NET especificado. Coloque o nome do tipo entre colchetes.

Por exemplo, Get-Process | Where-Object StartTime -Is [datetime]

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsNot

Indica que esse cmdlet obtém objetos se o valor da propriedade não for uma instância do tipo .NET especificado.

Por exemplo, Get-Process | where StartTime -IsNot [datetime]

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LE

Indica que esse cmdlet obtém objetos se o valor da propriedade for menor ou igual ao valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Like

Indica que esse cmdlet obtém objetos se o valor da propriedade corresponder a um valor que inclua caracteres curinga (*).

Por exemplo: Get-Process | Where-Object ProcessName -Like "*host"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LT

Indica que esse cmdlet obtém objetos se o valor da propriedade for menor que o valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Match

Indica que esse cmdlet obtém objetos se o valor da propriedade corresponder à expressão regular especificada. Quando a entrada é um único objeto, o valor correspondente é salvo na variável automática $Matches.

Por exemplo: Get-Process | Where-Object ProcessName -Match "shell"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NE

Indica que esse cmdlet obtém objetos se o valor da propriedade for diferente do valor especificado.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Not

Indica que esse cmdlet obtém objetos se a propriedade não existir ou tiver um valor de $null ou $false.

Por exemplo: Get-Service | Where-Object -Not "DependentServices"

Esse parâmetro foi introduzido no Windows PowerShell 6.1.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NotContains

Indica que esse cmdlet obtém objetos se nenhum dos itens no valor da propriedade for uma correspondência exata para o valor especificado.

Por exemplo: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains refere-se a uma coleção de valores e é true se a coleção não contiver nenhum item que seja uma correspondência exata para o valor especificado. Se a entrada for um único objeto, o PowerShell a converterá em uma coleção de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NotIn

Indica que esse cmdlet obtém objetos se o valor da propriedade não for uma correspondência exata para qualquer um dos valores especificados.

Por exemplo: Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName

Se o valor de Value for um único objeto, o PowerShell o converterá em uma coleção de um objeto.

Se o valor da propriedade de um objeto for uma matriz, o PowerShell usará a igualdade de referência para determinar uma correspondência. Where-Object retorna o objeto somente se o valor de Property e qualquer valor de Value não forem a mesma instância de um objeto.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NotLike

Indica que esse cmdlet obtém objetos se o valor da propriedade não corresponder a um valor que inclua caracteres curinga (*).

Por exemplo: Get-Process | Where-Object ProcessName -NotLike "*host"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NotMatch

Indica que esse cmdlet obtém objetos quando o valor da propriedade não corresponde à expressão regular especificada. Quando a entrada é um único objeto, o valor correspondente é salvo na variável automática $Matches.

Por exemplo: Get-Process | Where-Object ProcessName -NotMatch "powershell"

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Property

Especifica o nome de uma propriedade do objeto de entrada. A propriedade deve ser uma propriedade de instância, não uma propriedade estática. Este é um parâmetro posicional, portanto, o nome, Property, é opcional.

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Value

Especifica um valor de propriedade. O nome do parâmetro, Value, é opcional. Este parâmetro aceita caracteres curinga quando usado com os seguintes parâmetros de comparação:

• CLike
• CNotLike
• Gosto
• Não gosto

Esse parâmetro foi introduzido no Windows PowerShell 3.0.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

PSObject

Saídas

Object

Notas

Ligações Relacionadas

• Comparar-Objeto
• ForEach-Object
• Agrupar-Objeto
• Medir-Objeto
• Novo-Objeto
• Selecionar-Objeto
• Ordenar-Objeto
• Tee-Object
• about_Booleans