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

Description

Cmdleten Where-Object väljer objekt som har specifika egenskapsvärden från samlingen av objekt som skickas till den. Du kan till exempel använda cmdleten Where-Object för att välja filer som skapades efter ett visst datum, händelser med ett visst ID eller datorer som använder en viss version av Windows.

Från och med Windows PowerShell 3.0 finns det två olika sätt att konstruera ett Where-Object kommando.

• Skriptblock. Du kan använda ett skriptblock för att ange egenskapsnamnet, en jämförelseoperator och ett egenskapsvärde. Where-Object returnerar alla objekt som skriptblockssatsen är sann för.

  Följande kommando hämtar till exempel processer i prioritetsklassen Normal , det vill säga processer där värdet för egenskapen PriorityClass är Normallika med .

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

  Alla PowerShell-jämförelseoperatorer är giltiga i skriptblockformatet. Mer information finns i about_Comparison_Operators.

• Jämförelseuttryck. Du kan också skriva en jämförelseöversikt, som är mycket mer likt naturligt språk. Jämförelseinstruktioner introducerades i Windows PowerShell 3.0.

  Följande kommandon hämtar till exempel även processer som har prioritetsklassen Normal. Dessa kommandon är likvärdiga och du kan använda dem utbytbart.

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

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

  Från och med Windows PowerShell 3.0 Where-Object lägger du till jämförelseoperatorer som parametrar i ett Where-Object kommando. Om inget anges är alla operatorer skiftlägeskänsliga. Före Windows PowerShell 3.0 var jämförelseoperatorerna på PowerShell-språket endast användbara i skriptblock.

När du anger en enskild egenskap till Where-Objectbehandlar cmdleten egenskapens värde som ett booleskt uttryck. När värdet för egenskapens Längd inte är noll utvärderas uttrycket till $true. Till exempel: ('hi', '', 'there') | Where-Object Length

Föregående exempel är funktionellt likvärdigt med:

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

Mer information om hur PowerShell utvärderar booleska värden finns i about_Booleans.

Exempel

Exempel 1: Hämta stoppade tjänster

Dessa kommandon får en lista över alla tjänster som har stoppats. Den $_ automatiska variabeln representerar varje objekt som skickas till cmdleten Where-Object .

Det första kommandot använder skriptblockformatet. Det andra kommandot använder jämförelseuttrycksformatet. Kommandona filtrerar tjänsterna på samma sätt och returnerar samma utdata. Endast syntaxen är annorlunda.

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

Exempel 2: Hämta processer baserat på arbetsuppsättning

Dessa kommandon listar processer som har en arbetsuppsättning som är större än 250 mb (MB). Kommandona filtrerar processerna på samma sätt och returnerar samma utdata. Endast syntaxen är annorlunda.

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

Exempel 3: Hämta processer baserat på processnamn

Dessa kommandon hämtar de processer som har ett ProcessName-egenskapsvärde som börjar med bokstaven p. Med operatorn Match kan du använda reguljära uttrycksmatchningar.

Kommandona filtrerar processerna på samma sätt och returnerar samma utdata. Endast syntaxen är annorlunda.

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

Exempel 4: Använd jämförelseuttrycksformatet

Det här exemplet visar hur du använder cmdletens Where-Object nya jämförelseuttrycksformat.

Det första kommandot använder jämförelseuttrycksformatet. Den använder inga alias och innehåller namnet på varje parameter.

Det andra kommandot är den mer naturliga användningen av jämförelsekommandoformatet. Kommandot ersätter aliaset where för cmdlet-namnet Where-Object och utelämnar alla valfria parameternamn.

Kommandona filtrerar processerna på samma sätt och returnerar samma utdata. Endast syntaxen är annorlunda.

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

Exempel 5: Hämta kommandon baserat på egenskaper

Det här exemplet visar hur du skriver kommandon som returnerar objekt som är sanna eller falska eller har något värde för en angiven egenskap. Varje exempel visar både skriptblock- och jämförelseuttrycksformaten för kommandot.

Kommandona filtrerar sina indata på samma sätt och returnerar samma utdata. Endast syntaxen är annorlunda.

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

Exempel 6: Använd flera villkor

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

Det här exemplet visar hur du skapar ett Where-Object kommando med flera villkor.

Det här kommandot hämtar moduler som inte är kärnmoduler som stöder funktionen Updatable Help. Kommandot använder parametern ListAvailable för cmdleten Get-Module för att hämta alla moduler på datorn. En pipelineoperator (|) skickar modulerna till cmdletenWhere-Object, som hämtar moduler vars namn inte börjar med Microsoft eller PSoch har ett värde för egenskapen HelpInfoURI, som talar om för PowerShell var du hittar uppdaterade hjälpfiler för modulen. Den -and logiska operatorn ansluter jämförelseinstruktionerna.

I exemplet används skriptblockskommandoformatet. Logiska operatorer, till exempel -and,-or, och -not är endast giltiga i skriptblock. Du kan inte använda dem i jämförelseuttrycksformatet för ett Where-Object kommando.

• Mer information om logiska PowerShell-operatorer finns i about_Logical_Operators.
• Mer information om funktionen Updatable Help finns i about_Updatable_Help.

Parametrar

-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

Indata

PSObject

Du kan skicka valfritt objekt till den här cmdleten.

Utdata

Object

Den här cmdleten returnerar de markerade objekten från indataobjektuppsättningen.

Kommentarer

Windows PowerShell innehåller följande alias för Where-Object:

• ?
• where

Från och med Windows PowerShell 4.0 Where har ForEach metoder lagts till för användning med samlingar.

Du kan läsa mer om dessa metoder här about_arrays

Relaterade länkar

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