Where-Object

Verb: WhereChapter 4: Select-Object, Where-Object, and Sort-Object

Keeps only objects that pass a test.

Syntax

Short syntax for this command. The parameter table below may list more parameters than this short line shows.

Syntax
Where-Object { <test> }

Parameters

No named parameter in common use: the test is a script block using $_

Examples

Keeps only running services.

Example 1
Get-Service | Where-Object { $_.Status -eq "Running" }

Illustrative output: see the lesson example for this command.

Common mistakes

General cautions for this command.

  • Guessing parameters instead of checking Get-Help for this command.
  • Running a changing form of this command before previewing its effect.

Related commands

Commands that share this command's lesson come first, then commands that share its verb. Every link goes to a real command page.

Related lessons