Where-Object

Before running this

This is a reference for PowerShell; commands do not run on this page. Use the matching shell on your own computer. Read the example, expected result and notes before trying it. New to terminals? Start with the shell basics.

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.

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