Where-Object

Syntax

EqualSet (Standard)

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

Exempel

Exempel 1: Hämta stoppade tjänster

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

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

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

Exempel 3: Hämta processer baserat på processnamn

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

Exempel 4: Använd jämförelseuttrycksformatet

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

Exempel 5: Hämta kommandon baserat på egenskaper

# 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

Exempel 6: Använd flera villkor

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

Parametrar

-CContains

Anger att den här cmdleten hämtar objekt från en samling om objektets egenskapsvärde är en exakt matchning för det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where ProcessName -CContains "svchost"

CContains refererar till en samling värden och är sant om samlingen innehåller ett objekt som är en exakt matchning för det angivna värdet. Om indata är ett enda objekt konverterar PowerShell det till en samling med ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CEQ

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är detsamma som det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CGE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är större än eller lika med det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CGT

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är större än det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CIn

Anger att den här cmdleten hämtar objekt om egenskapsvärdet innehåller det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where -Value "svchost" -CIn ProcessName

CIn liknar CContains, förutom att egenskaps- och värdepositionerna är omvända. Följande instruktioner är till exempel båda sanna.

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

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

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CLE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är mindre än eller lika med det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CLike

Anger att den här cmdleten hämtar objekt om egenskapsvärdet matchar ett värde som innehåller jokertecken. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where ProcessName -CLike "*host"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CLT

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är mindre än det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CMatch

Anger att den här cmdleten hämtar objekt om egenskapsvärdet matchar det angivna reguljära uttrycket. Den här åtgärden är skiftlägeskänslig. När indata är skalär sparas det matchade värdet i $Matches automatisk variabel.

Till exempel: Get-Process | where ProcessName -CMatch "Shell"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CNE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet skiljer sig från det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CNotContains

Anger att den här cmdleten hämtar objekt om egenskapsvärdet för objektet inte är en exakt matchning för det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where ProcessName -CNotContains "svchost"

"NotContains" och "CNotContains refererar till en samling värden och är sanna när samlingen inte innehåller några objekt som är en exakt matchning för det angivna värdet. Om indata är ett enda objekt konverterar PowerShell det till en samling med ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CNotIn

Anger att den här cmdleten hämtar objekt om egenskapsvärdet inte är en exakt matchning för det angivna värdet. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where -Value "svchost" -CNotIn -Property ProcessName

Operatorerna NotIn och CNotIn liknar NotContains och CNotContains, förutom att egenskaps- och värdepositionerna är omvända. Följande instruktioner är till exempel sanna.

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

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

Parameteregenskaper

Parameteruppsättningar

-CNotLike

Anger att den här cmdleten hämtar objekt om egenskapsvärdet inte matchar ett värde som innehåller jokertecken. Den här åtgärden är skiftlägeskänslig.

Till exempel: Get-Process | where ProcessName -CNotLike "*host"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-CNotMatch

Anger att den här cmdleten hämtar objekt om egenskapsvärdet inte matchar det angivna reguljära uttrycket. Den här åtgärden är skiftlägeskänslig. När indata är skalär sparas det matchade värdet i $Matches automatisk variabel.

Till exempel: Get-Process | where ProcessName -CNotMatch "Shell"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Contains

Anger att den här cmdleten hämtar objekt om ett objekt i objektets egenskapsvärde är en exakt matchning för det angivna värdet.

Till exempel: Get-Process | where ProcessName -Contains "Svchost"

Om egenskapsvärdet innehåller ett enda objekt konverterar PowerShell det till en samling med ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-EQ

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är detsamma som det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-FilterScript

Anger det skriptblock som används för att filtrera objekten. Omslut skriptblocket i klammerparenteser ( {} ).

Parameternamnet FilterScript är valfritt.

Parameteregenskaper

Parameteruppsättningar

-GE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är större än eller lika med det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-GT

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är större än det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-In

Anger att den här cmdleten hämtar objekt om egenskapsvärdet matchar något av de angivna värdena.

Till exempel: Get-Process | where -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"

Om värdet för parametern Value är ett enda objekt konverterar PowerShell det till en samling med ett objekt.

Om egenskapsvärdet för ett objekt är en matris använder PowerShell referensjämlikhet för att fastställa en matchning. Where-Objectreturnerar endast objektet om värdet för egenskapsparametern och värde för Värde är samma instans av ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-InputObject

Anger vilka objekt som ska filtreras. Du kan också skicka objekten till Where-Object.

När du använder parametern InputObject med Where-Object, i stället för att skicka kommandoresultat till Where-Object, behandlas InputObject-värdet som ett enda objekt. Detta gäller även om värdet är en samling som är resultatet av ett kommando, till exempel -InputObject (Get-Process). Eftersom InputObject inte kan returnera enskilda egenskaper från en matris eller samling objekt rekommenderar vi att du använder Where-Object för att filtrera en samling objekt för objekt som har specifika värden i definierade egenskaper, använder du Where-Object i pipelinen, som du ser i exemplen i det här avsnittet.

Parameteregenskaper

Parameteruppsättningar

-Is

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är en instans av den angivna .NET Framework-typen. Omslut typnamnet inom hakparenteser.

Till exempel: Get-Process | where StartTime -Is [DateTime]

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-IsNot

Anger att denna cmdlet hämtar objekt om egenskapsvärdet inte är en instans av den angivna .NET Framework-typen.

Till exempel: Get-Process | where StartTime -IsNot [DateTime]

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-LE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är mindre än eller lika med det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Like

Anger att den här cmdleten hämtar objekt om egenskapsvärdet matchar ett värde som innehåller jokertecken.

Till exempel: Get-Process | where ProcessName -Like "*host"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-LT

Anger att den här cmdleten hämtar objekt om egenskapsvärdet är mindre än det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Match

Anger att den här cmdleten hämtar objekt om egenskapsvärdet matchar det angivna reguljära uttrycket. När indata är skalär sparas det matchade värdet i $Matches automatisk variabel.

Till exempel: Get-Process | where ProcessName -Match "shell"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-NE

Anger att den här cmdleten hämtar objekt om egenskapsvärdet skiljer sig från det angivna värdet.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-NotContains

Anger att denna cmdlet hämtar objekt om inget av objekten i egenskapsvärdet är en exakt matchning för det angivna värdet.

Till exempel: Get-Process | where ProcessName -NotContains "Svchost"

NotContains refererar till en samling värden och är sant om samlingen inte innehåller några objekt som är en exakt matchning för det angivna värdet. Om indata är ett enda objekt konverterar PowerShell det till en samling med ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-NotIn

Anger att denna cmdlet hämtar objekt om egenskapsvärdet inte är en exakt matchning för något av de angivna värdena.

Till exempel: Get-Process | where -Value "svchost" -NotIn -Property ProcessName

Om värdet för Värde är ett enskilt objekt konverterar PowerShell det till en samling med ett objekt.

Om egenskapsvärdet för ett objekt är en matris använder PowerShell referensjämlikhet för att fastställa en matchning. Where-Object returnerar endast objektet om värdet för -egenskapen och något värde för Värde inte är samma instans av ett objekt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-NotLike

Anger att den här cmdleten hämtar objekt om egenskapsvärdet inte matchar ett värde som innehåller jokertecken.

Till exempel: Get-Process | where ProcessName -NotLike "*host"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-NotMatch

Anger att den här cmdleten hämtar objekt när egenskapsvärdet inte matchar det angivna reguljära uttrycket. När indata är skalär sparas det matchade värdet i $Matches automatisk variabel.

Till exempel: Get-Process | where ProcessName -NotMatch "PowerShell"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Property

Anger namnet på en objektegenskap.

Parameternamnet egenskapär valfritt.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Value

Anger ett egenskapsvärde. Parameternamnet Värde är valfritt. Den här parametern accepterar jokertecken när den används med följande jämförelseparametrar:

• CLike
• CNotLike
• Likt
• Inte gilla

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

PSObject

Utdata

Object

Kommentarer

Relaterade länkar

• Compare-Object
• ForEach-Object
• Grupp-Objekt
• Measure-Object
• New-Object
• Välj-Objekt
• Sortera-Objekt
• Tee-Object