Where-Object

Modul:: Microsoft.PowerShell.Core Module

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

Syntaxe

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.

Syntaxe bloku 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, kde hodnota PriorityClass vlastnost 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.
Zjednodušená syntaxe Pokud chcete povolit simiplifikovanou syntaxi, Where-Object zahrnuje parametry přepínače 31, které představují relační operátory. Zjednodušená syntaxe se snadněji čte a zapisuje než syntaxe bloku skriptu. Můžete zkombinovat jeden z parametrů přepínače s parametry Property and Value a vytvořit příkaz, který filtruje objekty na základě hodnot jejich vlastností.

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 -Value Normal -EQ

Get-Process | Where-Object PriorityClass -EQ Normal

Jak je znázorněno v příkladu, názvy parametrů Vlastnost a Hodnota jsou volitelné. Parametr Property je poziční parametr mapovaný na pozici 0. Parametr Value je poziční parametr mapovaný na pozici 1. Parametr přepínače, který slouží k určení porovnání, lze použít v libovolné pozici.

Zjednodušená syntaxe byla zavedena ve Windows PowerShellu 3.0. Další informace najdete v tématu about_Simplified_Syntax.

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 a parametr Match umožňují 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.

Další informace o logických operátorech PowerShellu najdete v tématu about_Logical_Operators.
Další informace o funkci Aktualizovatelná nápověda najdete v tématu about_Updatable_Help.

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

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

Where-Object

Syntaxe

EqualSet (Výchozí)

ScriptBlockSet

MatchSet

CaseSensitiveEqualSet

NotEqualSet

CaseSensitiveNotEqualSet

GreaterThanSet

CaseSensitiveGreaterThanSet

LessThanSet

CaseSensitiveLessThanSet

GreaterOrEqualSet

CaseSensitiveGreaterOrEqualSet

LessOrEqualSet

CaseSensitiveLessOrEqualSet

LikeSet

CaseSensitiveLikeSet

NotLikeSet

CaseSensitiveNotLikeSet

CaseSensitiveMatchSet

NotMatchSet

CaseSensitiveNotMatchSet

ContainsSet

CaseSensitiveContainsSet

NotContainsSet

CaseSensitiveNotContainsSet

InSet

CaseSensitiveInSet

NotInSet

CaseSensitiveNotInSet

IsSet

IsNotSet

Not

Description

Příklady

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

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

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

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

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

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

Parametry

-CContains

Vlastnosti parametru

Sady parametrů

-CEQ

Vlastnosti parametru

Sady parametrů

-CGE

Vlastnosti parametru

Sady parametrů

-CGT

Vlastnosti parametru

Sady parametrů

-CIn

Vlastnosti parametru

Sady parametrů

-CLE

Vlastnosti parametru

Sady parametrů

-CLike

Vlastnosti parametru

Sady parametrů

-CLT

Vlastnosti parametru

Sady parametrů

-CMatch

Vlastnosti parametru

Sady parametrů

-CNE

Vlastnosti parametru

Sady parametrů

-CNotContains

Vlastnosti parametru

Sady parametrů

-CNotIn

Vlastnosti parametru

Sady parametrů