创建控制哪些对象沿着命令管道传递的筛选器。
语法
Where-Object [-FilterScript] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]
说明
Where-Object cmdlet 从传递给它的对象集合中选择对象。它使用脚本块作为筛选器,并对每个对象的脚本块进行评估。如果评估结果为“True”,则返回该对象。如果评估结果不是“True”,则忽略该对象。
参数
-FilterScript <scriptblock>
指定用于筛选对象的脚本块。脚本块需放在大括号 ({}) 中。
是否为必需? |
true |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-InputObject <psobject>
指定要筛选的对象。还可将对象通过管道传递给 Where-Object。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByValue) |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
System.Management.Automation.PSObject 可以通过管道将要筛选的对象传递给 Where-Object。 |
输出 |
示例 1
C:\PS>get-service | where-object {$_.Status -eq "Stopped"} 说明 ----------- 此命令获取当前被停止的所有服务的列表。“$”符号代表传递给 Where-Object cmdlet 的每个对象。
示例 2
C:\PS>get-process | where-object {$_.workingset -gt 25000*1024} 说明 ----------- 此命令列出了工作集大于 25,000 KB(千字节)的进程。由于 WorkingSet 属性的值以字节存储,因此需将值 25,000 与 1,024 相乘。
示例 3
C:\PS>get-process | where-object { $_.ProcessName -match "^p.*" } 说明 ----------- 此命令获取 ProcessName 属性以字母“p”开头的进程。通过此匹配运算符,您可以在 Where 子句中使用正则表达式。
示例 4
C:\PS>get-process -name svchost | where-object {$True} 说明 ----------- 此命令列出名为“svchost”的所有进程。 Where-Object cmdlet 对脚本块进行评估(脚本块通常包含对管道 ($_) 中的当前对象的引用),并将结果强制转换为布尔类型:True 或 False。如果结果为“True”,则返回该对象。否则,将丢弃该对象。 在本例中,脚本块仅返回 True,因此将返回所有对象。