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

Beschreibung

Beispiele

Beispiel 1: Get stopped services

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

Beispiel 2: Abrufen von Prozessen basierend auf dem Arbeitssatz

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

Beispiel 3: Abrufen von Prozessen basierend auf dem Prozessnamen

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

Beispiel 4: Verwenden des Vergleichsanweisungsformats

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

Beispiel 5: Abrufen von Befehlen basierend auf Eigenschaften

# 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

Beispiel 6: Verwenden mehrerer Bedingungen

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

Parameter

-CContains

Gibt an, dass dieses Cmdlet Objekte aus einer Auflistung abruft, wenn der Eigenschaftswert des Objekts eine genaue Übereinstimmung für den angegebenen Wert ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Beispiel: Get-Process | where ProcessName -CContains "svchost"

CContains bezieht sich auf eine Auflistung von Werten und ist true, wenn die Auflistung ein Element enthält, das eine genaue Übereinstimmung für den angegebenen Wert darstellt. Wenn es sich bei der Eingabe um ein einzelnes Objekt handelt, konvertiert PowerShell sie in eine Auflistung eines Objekts.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CEQ

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit dem angegebenen Wert identisch ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CGE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert größer oder gleich dem angegebenen Wert ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CGT

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert größer als der angegebene Wert ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CIn

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert den angegebenen Wert enthält. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Beispiel: Get-Process | where -Value "svchost" -CIn ProcessName

CIn ähnelt CContains, außer dass die Eigenschafts- und Wertpositionen umgekehrt werden. Die folgenden Anweisungen sind z. B. "true".

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

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

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CLE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert kleiner oder gleich dem angegebenen Wert ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CLike

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit einem Wert übereinstimmt, der Platzhalterzeichen enthält. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Beispiel: Get-Process | where ProcessName -CLike "*host"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CLT

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert kleiner als der angegebene Wert ist. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CMatch

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit dem angegebenen regulären Ausdruck übereinstimmt. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet. Wenn die Eingabe skalar ist, wird der übereinstimmende Wert in $Matches der automatischen Variablen gespeichert.

Beispiel: Get-Process | where ProcessName -CMatch "Shell"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CNE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn sich der Eigenschaftswert von dem angegebenen Wert unterscheidet. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CNotContains

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert des Objekts nicht genau mit dem angegebenen Wert übereinstimmt. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Beispiel: Get-Process | where ProcessName -CNotContains "svchost"

"NotContains" und "CNotContains" beziehen sich auf eine Auflistung von Werten und sind true, wenn die Auflistung keine Elemente enthält, die genau mit dem angegebenen Wert übereinstimmen. Wenn es sich bei der Eingabe um ein einzelnes Objekt handelt, konvertiert PowerShell sie in eine Auflistung eines Objekts.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CNotIn

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht genau mit dem angegebenen Wert übereinstimmt. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

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

NotIn- und CNotIn-Operatoren ähneln NotContains und CNotContains, mit der Ausnahme, dass die Eigenschafts- und Wertpositionen umgekehrt werden. Die folgenden Anweisungen sind beispielsweise "true".

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

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

Parametereigenschaften

Parametersätze

-CNotLike

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht mit einem Wert übereinstimmt, der Platzhalterzeichen enthält. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet.

Beispiel: Get-Process | where ProcessName -CNotLike "*host"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-CNotMatch

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht mit dem angegebenen regulären Ausdruck übereinstimmt. Bei diesem Vorgang wird die Groß-/Kleinschreibung beachtet. Wenn die Eingabe skalar ist, wird der übereinstimmende Wert in $Matches der automatischen Variablen gespeichert.

Beispiel: Get-Process | where ProcessName -CNotMatch "Shell"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Contains

Gibt an, dass dieses Cmdlet Objekte abruft, wenn ein Element im Eigenschaftswert des Objekts eine genaue Übereinstimmung für den angegebenen Wert ist.

Beispiel: Get-Process | where ProcessName -Contains "Svchost"

Wenn der Eigenschaftswert ein einzelnes Objekt enthält, konvertiert PowerShell ihn in eine Auflistung eines Objekts.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-EQ

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit dem angegebenen Wert identisch ist.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-FilterScript

Gibt den Skriptblock an, der zum Filtern der Objekte verwendet wird. Schließen Sie den Skriptblock in geschweifte Klammern ( {} ) ein.

Der Parametername FilterScript ist optional.

Parametereigenschaften

Parametersätze

-GE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert größer oder gleich dem angegebenen Wert ist.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-GT

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert größer als der angegebene Wert ist.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-In

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit einem der angegebenen Werte übereinstimmt.

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

Wenn es sich bei dem Wert des Value-Parameters um ein einzelnes Objekt handelt, konvertiert PowerShell ihn in eine Auflistung eines Objekts.

Wenn der Eigenschaftswert eines Objekts ein Array ist, verwendet PowerShell die Referenzgleichheit, um eine Übereinstimmung zu ermitteln. Where-Object gibt das Objekt nur zurück, wenn der Wert des Property-Parameters und ein beliebiger Wert von Value dieselbe Instanz eines Objekts sind.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-InputObject

Gibt die Objekte an, die gefiltert werden sollen. Sie können die Objekte auch an Where-Objectpfeifen.

Wenn Sie den InputObject-Parameter mit Where-Object, anstelle von Befehlsergebnissen Where-Objectan die Leitung, verwenden, wird der InputObject-Wert als einzelnes Objekt behandelt. Dies gilt auch dann, wenn es sich bei dem Wert um eine Auflistung handelt, die das Ergebnis eines Befehls ist, z -InputObject (Get-Process). B. Da InputObject keine einzelnen Eigenschaften aus einem Array oder einer Auflistung von Objekten zurückgeben kann, wird empfohlen, dass Sie in der Pipeline verwendenWhere-Object, wenn Sie Where-Object eine Auflistung von Objekten filtern, die bestimmte Werte in definierten Eigenschaften aufweisen, wie in den Beispielen in diesem Thema gezeigt.

Parametereigenschaften

Parametersätze

-Is

Gibt an, dass dieses Cmdlet Objekte abruft, wenn es sich bei dem Eigenschaftswert um eine Instanz des angegebenen .NET Framework-Typs handelt. Schließen Sie den Typnamen in eckige Klammern ein.

Beispiel: Get-Process | where StartTime -Is [DateTime]

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-IsNot

Gibt an, dass dieses Cmdlet Objekte abruft, wenn es sich bei dem Eigenschaftswert nicht um eine Instanz des angegebenen .NET Framework-Typs handelt.

Beispiel: Get-Process | where StartTime -IsNot [DateTime]

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-LE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert kleiner oder gleich dem angegebenen Wert ist.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Like

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit einem Wert übereinstimmt, der Platzhalterzeichen enthält.

Beispiel: Get-Process | where ProcessName -Like "*host"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-LT

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert kleiner als der angegebene Wert ist.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Match

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert mit dem angegebenen regulären Ausdruck übereinstimmt. Wenn die Eingabe skalar ist, wird der übereinstimmende Wert in $Matches der automatischen Variablen gespeichert.

Beispiel: Get-Process | where ProcessName -Match "shell"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-NE

Gibt an, dass dieses Cmdlet Objekte abruft, wenn sich der Eigenschaftswert von dem angegebenen Wert unterscheidet.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-NotContains

Gibt an, dass dieses Cmdlet Objekte abruft, wenn keines der Elemente im Eigenschaftswert eine genaue Übereinstimmung für den angegebenen Wert ist.

Beispiel: Get-Process | where ProcessName -NotContains "Svchost"

NotContains bezieht sich auf eine Auflistung von Werten und ist true, wenn die Auflistung keine Elemente enthält, die genau mit dem angegebenen Wert übereinstimmen. Wenn es sich bei der Eingabe um ein einzelnes Objekt handelt, konvertiert PowerShell sie in eine Auflistung eines Objekts.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-NotIn

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht genau mit einem der angegebenen Werte übereinstimmt.

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

Wenn es sich bei dem Wert um ein einzelnes Objekt handelt, konvertiert PowerShell ihn in eine Auflistung eines Objekts.

Wenn der Eigenschaftswert eines Objekts ein Array ist, verwendet PowerShell die Referenzgleichheit, um eine Übereinstimmung zu ermitteln. Where-Object Gibt das Objekt nur zurück, wenn der Wert von Property und ein beliebiger Wert von Value nicht dieselbe Instanz eines Objekts sind.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-NotLike

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht mit einem Wert übereinstimmt, der Platzhalterzeichen enthält.

Beispiel: Get-Process | where ProcessName -NotLike "*host"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-NotMatch

Gibt an, dass dieses Cmdlet Objekte abruft, wenn der Eigenschaftswert nicht mit dem angegebenen regulären Ausdruck übereinstimmt. Wenn die Eingabe skalar ist, wird der übereinstimmende Wert in $Matches der automatischen Variablen gespeichert.

Beispiel: Get-Process | where ProcessName -NotMatch "PowerShell"

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Property

Gibt den Namen einer Objekteigenschaft an.

Der Parametername "Property" ist optional.

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

-Value

Gibt einen Eigenschaftswert an. Der Parametername "Value" ist optional. Dieser Parameter akzeptiert Bei Verwendung mit den folgenden Vergleichsparametern Wildcardzeichen:

• CLike
• CNotLike
• Mögen
• Nicht wie

Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

PSObject

Ausgaben

Object

Hinweise

Ähnliche Themen

• Compare-Object
• ForEach-Object
• Gruppenobjekt
• Measure-Object
• Neues Objekt
• Select-Object
• Sort-Object
• Tee-Object