Where-Object

Syntaxis

EqualSet (Standaard)

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

Voorbeelden

Voorbeeld 1: Gestopte services ophalen

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

Voorbeeld 2: Processen ophalen op basis van een werkset

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

Voorbeeld 3: Processen ophalen op basis van procesnaam

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

Voorbeeld 4: De indeling van de vergelijkingsinstructie gebruiken

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

Voorbeeld 5: Opdrachten ophalen op basis van eigenschappen

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

Voorbeeld 6: Meerdere voorwaarden gebruiken

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

Parameters

-CContains

Geeft aan dat deze cmdlet objecten ophaalt uit een verzameling als de eigenschapswaarde van het object exact overeenkomt met de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains verwijst naar een verzameling waarden en is waar als de verzameling een item bevat dat exact overeenkomt met de opgegeven waarde. Als de invoer één object is, converteert PowerShell het naar een verzameling van één object.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CEQ

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde hetzelfde is als de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CGE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde groter is dan of gelijk is aan de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CGT

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde groter is dan de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CIn

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde de opgegeven waarde bevat. Deze bewerking is hoofdlettergevoelig.

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

CIn lijkt op CContains, behalve dat de eigenschaps- en waardeposities worden omgekeerd. De volgende beweringen zijn bijvoorbeeld beide waar.

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

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CLE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde kleiner is dan of gelijk is aan de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CLike

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde overeenkomt met een waarde met jokertekens (*). Deze bewerking is hoofdlettergevoelig.

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CLT

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde kleiner is dan de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CMatch

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde overeenkomt met de opgegeven reguliere expressie. Deze bewerking is hoofdlettergevoelig. Wanneer de invoer één object is, wordt de overeenkomende waarde opgeslagen in de $Matches automatische variabele.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -CMatch "Shell"

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CNE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde anders is dan de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CNotContains

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde van het object niet exact overeenkomt met de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains en CNotContains verwijzen naar een verzameling waarden en zijn waar wanneer de verzameling geen items bevat die exact overeenkomen met de opgegeven waarde. Als de invoer één object is, converteert PowerShell het naar een verzameling van één object.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CNotIn

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde niet exact overeenkomt met de opgegeven waarde. Deze bewerking is hoofdlettergevoelig.

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

NotIn - en CNotIn-operators lijken op NotContains en CNotContains, behalve dat de eigenschaps- en waardeposities worden omgekeerd. De volgende instructies zijn bijvoorbeeld waar.

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

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

Parametereigenschappen

Parametersets

-CNotLike

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde niet overeenkomt met een waarde die jokertekens bevat. Deze bewerking is hoofdlettergevoelig.

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-CNotMatch

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde niet overeenkomt met de opgegeven reguliere expressie. Deze bewerking is hoofdlettergevoelig. Wanneer de invoer één object is, wordt de overeenkomende waarde opgeslagen in de $Matches automatische variabele.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Contains

Geeft aan dat deze cmdlet objecten ophaalt als een item in de eigenschapswaarde van het object een exacte overeenkomst is voor de opgegeven waarde.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -Contains "Svchost"

Als de invoer één object is, converteert PowerShell het naar een verzameling van één object.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-EQ

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde hetzelfde is als de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-FilterScript

Hiermee geeft u het scriptblok op dat wordt gebruikt om de objecten te filteren. Plaats het scriptblok tussen accolades ({}).

De parameternaam, FilterScript, is optioneel.

Parametereigenschappen

Parametersets

-GE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde groter is dan of gelijk is aan de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-GT

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde groter is dan de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-In

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde overeenkomt met een van de opgegeven waarden. Voorbeeld:

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

Als de invoer één object is, converteert PowerShell het naar een verzameling van één object.

Als de eigenschapswaarde van een object een matrix is, gebruikt PowerShell verwijzings gelijkheid om een overeenkomst te bepalen. Where-Object retourneert het object alleen als de waarde van de parameter Eigenschap en een waarde van waarde hetzelfde exemplaar van een object zijn.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-InputObject

Hiermee geeft u de objecten die moeten worden gefilterd. U kunt de objecten ook doorspezen naar Where-Object.

Wanneer u de parameter InputObject gebruikt met Where-Object, in plaats van de resultaten van de opdracht Where-Objectpiping, behandelt de cmdlet het InputObject als één object. Dit geldt zelfs als de waarde een verzameling is die het resultaat is van een opdracht, zoals -InputObject (Get-Process).

Omdat InputObject geen afzonderlijke eigenschappen kan retourneren uit een matrix of verzameling objecten, raden we u aan om, als u een Where-Object verzameling objecten filtert voor die objecten met specifieke waarden in gedefinieerde eigenschappen, in de pijplijn te gebruiken Where-Object , zoals wordt weergegeven in de voorbeelden in dit onderwerp.

Parametereigenschappen

Parametersets

-Is

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde een exemplaar is van het opgegeven .NET-type. Plaats de typenaam tussen vierkante haken.

Bijvoorbeeld Get-Process | Where-Object StartTime -Is [datetime]

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-IsNot

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde geen exemplaar is van het opgegeven .NET-type.

Bijvoorbeeld Get-Process | where StartTime -IsNot [datetime]

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-LE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde kleiner is dan of gelijk is aan de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Like

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde overeenkomt met een waarde met jokertekens (*).

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-LT

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde kleiner is dan de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Match

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde overeenkomt met de opgegeven reguliere expressie. Wanneer de invoer één object is, wordt de overeenkomende waarde opgeslagen in de $Matches automatische variabele.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -Match "shell"

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-NE

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde anders is dan de opgegeven waarde.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Not

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschap niet bestaat of een waarde van $null of $falseheeft.

Bijvoorbeeld: Get-Service | Where-Object -Not "DependentServices"

Deze parameter is geïntroduceerd in Windows PowerShell 6.1.

Parametereigenschappen

Parametersets

-NotContains

Geeft aan dat deze cmdlet objecten ophaalt als geen van de items in de eigenschapswaarde een exacte overeenkomst is voor de opgegeven waarde.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains verwijst naar een verzameling waarden en is waar als de verzameling geen items bevat die exact overeenkomen met de opgegeven waarde. Als de invoer één object is, converteert PowerShell het naar een verzameling van één object.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-NotIn

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde niet exact overeenkomt met een van de opgegeven waarden.

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

Als de waarde van waarde één object is, converteert PowerShell het naar een verzameling van één object.

Als de eigenschapswaarde van een object een matrix is, gebruikt PowerShell verwijzings gelijkheid om een overeenkomst te bepalen. Where-Object retourneert het object alleen als de waarde van eigenschap en een waarde van waarde niet hetzelfde exemplaar van een object zijn.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-NotLike

Geeft aan dat deze cmdlet objecten ophaalt als de eigenschapswaarde niet overeenkomt met een waarde met jokertekens (*).

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

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-NotMatch

Geeft aan dat deze cmdlet objecten ophaalt wanneer de eigenschapswaarde niet overeenkomt met de opgegeven reguliere expressie. Wanneer de invoer één object is, wordt de overeenkomende waarde opgeslagen in de $Matches automatische variabele.

Bijvoorbeeld: Get-Process | Where-Object ProcessName -NotMatch "powershell"

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Property

Hiermee geeft u de naam van een eigenschap van het invoerobject. De eigenschap moet een exemplaareigenschap zijn, niet een statische eigenschap. Dit is een positionele parameter, dus de naam, eigenschap, is optioneel.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-Value

Hiermee geeft u een eigenschapswaarde op. De parameternaam, Waarde, is optioneel. Deze parameter accepteert jokertekens bij gebruik met de volgende vergelijkingsparameters:

• CLike-
• CNotLike-
• Zoals
• NotLike-

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

PSObject

Uitvoerwaarden

Object

Notities

Verwante koppelingen

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