Where-Object

Syntax

EqualSet (Standard)

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

Exempel

Exempel 1: Hämta stoppade tjänster

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

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

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

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

Exempel 6: Använd flera villkor

Get-Module -ListAvailable | Where-Object {
    ($_.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-Object 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-Object -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-Object 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 ett enskilt objekt sparas det matchade värdet i den $Matches automatiska variabeln.

Till exempel: Get-Process | Where-Object 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-Object 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-Object -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-Object 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 ett enskilt objekt sparas det matchade värdet i den $Matches automatiska variabeln.

Till exempel: Get-Process | Where-Object 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-Object ProcessName -Contains "Svchost"

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

-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-Object -Property ProcessName -In -Value "Svchost", "TaskHost", "WsmProvHost"

Om indata ä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, behandlar cmdleten InputObject 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 en samling objekt rekommenderar vi att om du använder Where-Object för att filtrera en samling objekt för de objekt som har specifika värden i definierade egenskaper använder Where-Object du 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-typen. Omslut typnamnet inom hakparenteser.

Till exempel: Get-Process | Where-Object StartTime -Is [datetime]

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-IsNot

Anger att den här cmdleten hämtar objekt om egenskapsvärdet inte är en instans av den angivna .NET-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-Object 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 ett enskilt objekt sparas det matchade värdet i den $Matches automatiska variabeln.

Till exempel: Get-Process | Where-Object 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

-Not

Anger att den här cmdleten hämtar objekt om egenskapen inte finns eller har värdet $null eller $false.

Till exempel: Get-Service | Where-Object -Not "DependentServices"

Den här parametern introducerades i Windows PowerShell 6.1.

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-Object 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 den här cmdleten 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-Object -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 värdet 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-Object 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 ett enskilt objekt sparas det matchade värdet i den $Matches automatiska variabeln.

Till exempel: Get-Process | Where-Object ProcessName -NotMatch "powershell"

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-Property

Anger namnet på en egenskap för indataobjektet. Egenskapen måste vara en instansegenskap, inte en statisk egenskap. Det här är en positionsparameter, så namnet, 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
• about_Booleans