Field notesAUWENSearch
Explore Systems
← Command indexPowerShell / filter

Where-Object

Keep objects meeting a condition.

Syntax

UPPERCASE words are placeholders to replace. Brackets in the syntax line describe optional arguments; do not type those brackets literally.

INPUT | Where-Object { CONDITION }

Example

Get-ChildItem -File | Where-Object { $_.Length -gt 1024 }

Expected result

Files larger than 1 KiB in the current directory.

Notes and traps

$_ is the current pipeline object. Filter real properties before formatting output.

Related commands

Related tasks may need different flags and have different semantics. Check the entry before translating a command between shells.

Official reference ↗

Updated 13 September 2026. Examples describe the expected behavior; not every platform is available for execution testing.