Where-Object

Sintaxe

EqualSet (Predefinição)

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

ScriptBlockSet

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

LessOrEqualSet

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

CaseSensitiveGreaterOrEqualSet

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

CaseSensitiveLessOrEqualSet

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

CaseSensitiveInSet

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

GreaterOrEqualSet

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

CaseSensitiveLikeSet

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

NotLikeSet

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

CaseSensitiveNotLikeSet

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

MatchSet

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

CaseSensitiveMatchSet

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

NotMatchSet

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

CaseSensitiveNotMatchSet

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

ContainsSet

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

CaseSensitiveContainsSet

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

NotContainsSet

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

CaseSensitiveNotContainsSet

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

InSet

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

LikeSet

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

NotInSet

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

CaseSensitiveNotInSet

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

IsSet

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

IsNotSet

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

CaseSensitiveEqualSet

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

NotEqualSet

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

CaseSensitiveNotEqualSet

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

GreaterThanSet

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

CaseSensitiveGreaterThanSet

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

LessThanSet

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

CaseSensitiveLessThanSet

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

Description

Exemplos

Exemplo 1: Obter serviços interrompidos

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

Exemplo 2: Obter processos com base no conjunto de trabalho

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

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 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}

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 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 -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 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 é escalar, o valor correspondente é salvo em $Matches variável automática.

Por exemplo: Get-Process | where 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 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 itens que sejam 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 -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 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 é escalar, o valor correspondente é salvo em $Matches variável automática.

Por exemplo: Get-Process | where 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 ProcessName -Contains "Svchost"

Se o valor da propriedade contiver um único objeto, o PowerShell o 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 -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"

Se o valor do parâmetro 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 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 valor InputObject é tratado 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 Framework especificado. Coloque o nome do tipo entre colchetes.

Por exemplo, Get-Process | where 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 Framework 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 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 é escalar, o valor correspondente é salvo em $Matches variável automática.

Por exemplo: Get-Process | where 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

-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 ProcessName -NotContains "Svchost"

NotContains refere-se a uma coleção de valores e é true se a coleção não contiver itens que sejam 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 -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 retornará 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 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 é escalar, o valor correspondente é salvo em $Matches variável automática.

Por exemplo: Get-Process | where 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 de objeto.

O nome do parâmetro, 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