Sdílet prostřednictvím

Where-Object

Modul:
Microsoft.PowerShell.Core Module

Vybere objekty z kolekce na základě hodnot jejich vlastností.

Syntax

EqualSet (Výchozí) 

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

Rutina Where-Object vybere objekty, které mají konkrétní hodnoty vlastností z kolekce objektů, které jsou do ní předány. Pomocí rutiny Where-Object můžete například vybrat soubory vytvořené po určitém datu, události s určitým ID nebo počítači, které používají určitou verzi Windows.

Počínaje windows PowerShellem 3.0 existují dva různé způsoby vytvoření příkazu Where-Object.

  • blok skriptu. Blok skriptu můžete použít k určení názvu vlastnosti, relačního operátoru a hodnoty vlastnosti. Where-Object vrátí všechny objekty, pro které je příkaz bloku skriptu pravdivý.

    Například následující příkaz získá procesy ve třídě priority Normal, tj. procesy, kde hodnota vlastnosti PriorityClass se rovná Normal.

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

    Všechny relační operátory PowerShellu jsou platné ve formátu bloku skriptu. Pro více informací viz about_Comparison_Operators.

  • Příkaz Porovnání. Můžete také napsat porovnávací příkaz, který je mnohem více podobný přirozenému jazyku. Příkazy porovnání byly zavedeny ve Windows PowerShellu 3.0.

    Například následující příkazy také získávají procesy, které mají prioritu třídy Normal. Tyto příkazy jsou ekvivalentní a můžete je zaměnitelně.

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

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

    Počínaje windows PowerShellem 3.0 Where-Object přidá operátory porovnání jako parametry v příkazu Where-Object. Pokud není zadáno, nerozlišují se všechny operátory malá a velká písmena. Před Windows PowerShellem 3.0 byly relační operátory v jazyce PowerShell použitelné pouze v blocích skriptu.

Když zadáte jedinou vlastnostWhere-Object, rutina zachází s hodnotou vlastnosti jako s logickým výrazem. Pokud hodnota length vlastnosti není nula, výraz se vyhodnotí jako $true. Příklad: ('hi', '', 'there') | Where-Object Length

Předchozí příklad je funkčně ekvivalentní:

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

Další informace o tom, jak PowerShell vyhodnocuje logické hodnoty, najdete v tématu about_Booleans.

Příklady

Příklad 1: Získání zastavených služeb

Tyto příkazy získají seznam všech zastavených služeb. Automatická proměnná $_ představuje každý objekt předaný rutině Where-Object.

První příkaz používá formát bloku skriptu, druhý příkaz používá formát příkazu porovnání. Příkazy filtruje služby stejným způsobem a vrací stejný výstup. Pouze syntaxe se liší.

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

Příklad 2: Získání procesů na základě pracovní sady

Tyto příkazy uvádějí procesy, které mají pracovní sadu větší než 250 megabajtů (MB). Příkazy filtruje procesy stejným způsobem a vrací stejný výstup. Pouze syntaxe se liší.

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

Příklad 3: Získání procesů na základě názvu procesu

Tyto příkazy získají procesy, které mají hodnotu vlastnosti ProcessName , která začíná písmenem p. Operátor Match umožňuje používat shody regulárních výrazů.

Příkazy filtruje procesy stejným způsobem a vrací stejný výstup. Pouze syntaxe se liší.

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

Příklad 4: Použití formátu příkazu porovnání

Tento příklad ukazuje, jak používat nový formát příkazu porovnání rutiny Where-Object.

První příkaz používá formát příkazu porovnání. Nepoužívá žádné aliasy a obsahuje název každého parametru.

Druhým příkazem je přirozenější použití formátu příkazu porovnání. Příkaz nahradí alias where názvem rutiny Where-Object a vynechá všechny volitelné názvy parametrů.

Příkazy filtruje procesy stejným způsobem a vrací stejný výstup. Pouze syntaxe se liší.

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

Příklad 5: Získání příkazů na základě vlastností

Tento příklad ukazuje, jak psát příkazy, které vracejí položky, které mají hodnotu true nebo false nebo mají libovolnou hodnotu pro zadanou vlastnost. Každý příklad ukazuje formáty bloku skriptu i příkazu porovnání.

Příkazy filtrují vstup stejným způsobem a vrací stejný výstup. Pouze syntaxe se liší.

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

Příklad 6: Použití více podmínek

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

Tento příklad ukazuje, jak vytvořit příkaz Where-Object s více podmínkami.

Tento příkaz získá nejádrový modul, který podporuje funkci Aktualizovatelná nápověda. Příkaz pomocí parametru Get-Module rutiny získá všechny moduly v počítači. Operátor kanálu (|) odešle moduly do Where-Object rutiny, která získá moduly, jejichž názvy nezačínají Microsoft nebo PS, a mají hodnotu pro vlastnost HelpInfoURI , která říká PowerShellu, kde najít aktualizované soubory nápovědy pro modul. Logický operátor -and spojuje příkazy porovnání.

Příklad používá formát příkazu bloku skriptu. Logické operátory, jako jsou -and,-ora -not, jsou platné pouze v blocích skriptu. Nemůžete je použít ve formátu příkazu porovnání Where-Object.

Parametry

-CContains

Označuje, že tato rutina získá objekty z kolekce, pokud hodnota vlastnosti objektu je přesná shoda pro zadanou hodnotu. Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains odkazuje na kolekci hodnot a je true, pokud kolekce obsahuje položku, která je přesná shoda pro zadanou hodnotu. Pokud je vstup jedním objektem, PowerShell ho převede na kolekci jednoho objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveContainsSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CEQ

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti stejná jako zadaná hodnota. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CGE

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti větší nebo rovna zadané hodnotě. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveGreaterOrEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CGT

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti větší než zadaná hodnota. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveGreaterThanSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CIn

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti obsahuje zadanou hodnotu. Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object -Value "svchost" -CIn ProcessName

Funkce CIn se podobá CContains s tím rozdílem, že pozice vlastností a hodnot jsou obrácené. Například následující příkazy jsou pravdivé.

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

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

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveInSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CLE

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti menší nebo rovna zadané hodnotě. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveLessOrEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CLike

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti odpovídá hodnotě, která obsahuje zástupné znaky (*). Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object ProcessName -CLike "*host"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveLikeSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CLT

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti menší než zadaná hodnota. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveLessThanSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CMatch

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti odpovídá zadanému regulárnímu výrazu. Tato operace rozlišují malá a velká písmena. Pokud je vstup jedním objektem, odpovídající hodnota se uloží do $Matches automatické proměnné.

Příklad: Get-Process | Where-Object ProcessName -CMatch "Shell"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveMatchSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CNE

Označuje, že tato rutina získá objekty, pokud se hodnota vlastnosti liší od zadané hodnoty. Tato operace rozlišují malá a velká písmena.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveNotEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CNotContains

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti objektu není přesná shoda pro zadanou hodnotu. Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains a CNotContains odkazují na kolekci hodnot a jsou pravdivé, pokud kolekce neobsahuje žádné položky, které jsou přesné shody pro zadanou hodnotu. Pokud je vstup jedním objektem, PowerShell ho převede na kolekci jednoho objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveNotContainsSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CNotIn

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti není přesná shoda pro zadanou hodnotu. Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName

Operátory NotIn a CNotIn se podobají notContains a CNotContains, s tím rozdílem, že pozice vlastností a hodnot jsou obrácené. Například následující příkazy jsou pravdivé.

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

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveNotInSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CNotLike

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti neodpovídá hodnotě, která obsahuje zástupné znaky. Tato operace rozlišují malá a velká písmena.

Příklad: Get-Process | Where-Object ProcessName -CNotLike "*host"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveNotLikeSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CNotMatch

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti neodpovídá zadanému regulárnímu výrazu. Tato operace rozlišují malá a velká písmena. Pokud je vstup jedním objektem, odpovídající hodnota se uloží do $Matches automatické proměnné.

Příklad: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CaseSensitiveNotMatchSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Contains

Označuje, že tato rutina získá objekty, pokud jakákoli položka v hodnotě vlastnosti objektu je přesná shoda pro zadanou hodnotu.

Příklad: Get-Process | Where-Object ProcessName -Contains "Svchost"

Pokud je vstup jedním objektem, PowerShell ho převede na kolekci jednoho objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IContains

Sady parametrů

ContainsSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-EQ

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti stejná jako zadaná hodnota.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IEQ

Sady parametrů

EqualSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-FilterScript

Určuje blok skriptu, který se používá k filtrování objektů. Uzavřete blok skriptu do složených závorek ({}).

Název parametru FilterScript je volitelný.

Vlastnosti parametru

Typ:ScriptBlock
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ScriptBlockSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-GE

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti větší nebo rovna zadané hodnotě.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IGE

Sady parametrů

GreaterOrEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-GT

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti větší než zadaná hodnota.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IGT

Sady parametrů

GreaterThanSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-In

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti odpovídá některé ze zadaných hodnot. Například:

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

Pokud je vstup jedním objektem, PowerShell ho převede na kolekci jednoho objektu.

Pokud je hodnota vlastnosti objektu pole, PowerShell použije k určení shody rovnost odkazů. Where-Object vrátí objekt pouze v případě, že hodnota parametru Property a jakákoli hodnota Value je stejná instance objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IIn

Sady parametrů

InSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-InputObject

Určuje objekty, které se mají filtrovat. Objekty můžete také pipetovat do Where-Object.

Když použijete inputObject parametr s , místo Where-Objectpiping command výsledky do Where-Object, rutina zachází InputObject jako s jedním objektem. To platí i v případě, že hodnota je kolekce, která je výsledkem příkazu, například -InputObject (Get-Process).

Protože InputObject nemůže vracet jednotlivé vlastnosti z pole nebo kolekce objektů, doporučujeme, abyste vyfiltrovali Where-Object kolekci objektů pro tyto objekty, které mají určité hodnoty v definovaných vlastnostech, použijete Where-Object v kanálu, jak je znázorněno v příkladech v tomto tématu.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Is

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti instance zadaného typu .NET. Uzavřete název typu do hranatých závorek.

Například Get-Process | Where-Object StartTime -Is [DateTime]

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

IsSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-IsNot

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti není instancí zadaného typu .NET.

Například Get-Process | where StartTime -IsNot [DateTime]

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

IsNotSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LE

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti menší nebo rovna zadané hodnotě.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ILE

Sady parametrů

LessOrEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Like

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti odpovídá hodnotě, která obsahuje zástupné znaky (*).

Příklad: Get-Process | Where-Object ProcessName -Like "*host"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ILike

Sady parametrů

LikeSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LT

Označuje, že tato rutina získá objekty, pokud je hodnota vlastnosti menší než zadaná hodnota.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ILT

Sady parametrů

LessThanSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Match

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti odpovídá zadanému regulárnímu výrazu. Pokud je vstup jedním objektem, odpovídající hodnota se uloží do $Matches automatické proměnné.

Příklad: Get-Process | Where-Object ProcessName -Match "shell"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:IMatch

Sady parametrů

MatchSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NE

Označuje, že tato rutina získá objekty, pokud se hodnota vlastnosti liší od zadané hodnoty.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:INE

Sady parametrů

NotEqualSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Not

Označuje, že tato rutina získá objekty, pokud vlastnost neexistuje nebo má hodnotu $null nebo $false.

Příklad: Get-Service | Where-Object -Not "DependentServices"

Tento parametr byl představen ve Windows PowerShellu 6.1.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Not
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NotContains

Označuje, že tato rutina získá objekty, pokud žádná z položek v hodnotě vlastnosti není přesná shoda pro zadanou hodnotu.

Příklad: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains odkazuje na kolekci hodnot a je true, pokud kolekce neobsahuje žádné položky, které jsou přesnou shodou pro zadanou hodnotu. Pokud je vstup jedním objektem, PowerShell ho převede na kolekci jednoho objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:INotContains

Sady parametrů

NotContainsSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NotIn

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti není přesná shoda pro žádnou ze zadaných hodnot.

Příklad: Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName

Pokud je hodnota Value jedním objektem, PowerShell ji převede na kolekci jednoho objektu.

Pokud je hodnota vlastnosti objektu pole, PowerShell použije k určení shody rovnost odkazů. Where-Object vrátí objekt pouze v případě, že hodnota Vlastnosti a jakákoli hodnota Value nejsou stejnou instancí objektu.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:INotIn

Sady parametrů

NotInSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NotLike

Označuje, že tato rutina získá objekty, pokud hodnota vlastnosti neodpovídá hodnotě, která obsahuje zástupné znaky (*).

Příklad: Get-Process | Where-Object ProcessName -NotLike "*host"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:INotLike

Sady parametrů

NotLikeSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NotMatch

Označuje, že tato rutina získá objekty, když hodnota vlastnosti neodpovídá zadanému regulárnímu výrazu. Pokud je vstup jedním objektem, odpovídající hodnota se uloží do $Matches automatické proměnné.

Příklad: Get-Process | Where-Object ProcessName -NotMatch "PowerShell"

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:INotMatch

Sady parametrů

NotMatchSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Property

Určuje název vlastnosti vstupního objektu. Vlastnost musí být vlastnost instance, nikoli statická vlastnost. Jedná se o poziční parametr, takže název , Vlastnost, je nepovinný.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

EqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LessOrEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
GreaterThanSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveGreaterThanSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LessThanSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLessThanSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
GreaterOrEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveGreaterOrEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLessOrEqualSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LikeSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLikeSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotLikeSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotLikeSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
MatchSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveMatchSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotMatchSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotMatchSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
ContainsSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveContainsSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotContainsSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotContainsSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
InSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveInSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotInSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotInSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
IsSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
IsNotSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
Not
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Value

Určuje hodnotu vlastnosti. Název parametru Value je volitelný. Tento parametr přijímá zástupné znaky při použití s následujícími parametry porovnání:

  • CLike
  • CNotLike
  • jako
  • Nelíbí se mi

Tento parametr byl představen ve Windows PowerShellu 3.0.

Vlastnosti parametru

Typ:PSObject
Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

EqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveGreaterOrEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
GreaterThanSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveGreaterThanSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LessThanSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLessThanSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
GreaterOrEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LessOrEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLessOrEqualSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
LikeSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveLikeSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotLikeSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotLikeSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
MatchSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveMatchSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotMatchSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotMatchSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
ContainsSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveContainsSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotContainsSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotContainsSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
InSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveInSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
NotInSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
CaseSensitiveNotInSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
IsSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
IsNotSet
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSObject

K tomuto cmdletu můžete přesměrovat libovolný objekt.

Výstupy

Object

Tato rutina vrátí vybrané položky ze vstupní sady objektů.

Poznámky

PowerShell obsahuje následující aliasy pro Where-Object:

  • Všechny platformy:
    • ?
    • where

Počínaje windows PowerShellem 4.0 byly přidány metody Where a ForEach pro použití s kolekcemi.

Další informace o těchto metodách najdete about_arrays