Where-Object

Syntaxe

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     [-EQ]
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-FilterScript] <ScriptBlock>
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Match
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CEQ
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -GT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CGT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -LT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLT
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -GE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CGE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -LE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLE
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Like
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotLike
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotMatch
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Contains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotContains
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -In
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -NotIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -CNotIn
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -Is
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     [[-Value] <Object>]
     -IsNot
     [<CommonParameters>]

Where-Object
     [-InputObject <PSObject>]
     [-Property] <String>
     -Not
     [<CommonParameters>]

Description

Rutina Where-Object vybere objekty, které mají konkrétní hodnoty vlastností z kolekce objektů, které jsou do ní předány. Pomocí této 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í konkrétní verzi Windows.

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

• 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 Normal třídě priority, to znamená 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. Další informace najdete v tématu 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 Where-Object příkazu. 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 vlastnost Where-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 Shoda 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žít 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í where alias názvu Where-Object rutiny 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 Where-Object příkaz 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 ListAvailable 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ý -and operátor spojuje příkazy porovnání.

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

• 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

-CEQ

-CGE

-CGT

-CIn

-CLE

-CLike

-CLT

-CMatch

-CNE

-CNotContains

-CNotIn

-CNotLike

-CNotMatch

-Contains

-EQ

-FilterScript

-GE

-GT

-In

-InputObject

-Is

-IsNot

-LE

-Like

-LT

-Match

-NE

-Not

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

Vstupy

PSObject

Do této rutiny můžete převést 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 Where a ForEach metody byly přidány pro použití s kolekcemi.

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

Související odkazy

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