Where-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.