Where-Object

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    [-InputObject <PSObject>]
    [-EQ]
    [<CommonParameters>]

Where-Object
    [-FilterScript] <ScriptBlock>
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Match
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CEQ
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -GT
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CGT
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -LT
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLT
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -GE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CGE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -LE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLE
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Like
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotLike
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotMatch
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Contains
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotContains
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -In
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -NotIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -CNotIn
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -Is
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    [[-Value] <Object>]
    -IsNot
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object
    [-Property] <String>
    -Not
    [-InputObject <PSObject>]
    [<CommonParameters>]

Where-Object cmdlet 从传递给它的对象的集合中选择具有特定属性值的对象。 例如，可以使用 Where-Object cmdlet 来选择在特定日期之后创建的文件、具有特定 ID 的事件或使用特定版本的 Windows 的计算机。

从 Windows PowerShell 3.0 开始，可通过两种不同的方法来构造 Where-Object 命令。

• 脚本块语法。 可以使用脚本块来指定属性名称、比较运算符和属性值。 Where-Object 返回脚本块语句为 true 的所有对象。

  例如，以下命令获取 PriorityClass 属性的值等于 Normal的进程。

  Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}

  所有 PowerShell 比较运算符都以脚本块格式有效。 有关详细信息，请参阅 about_Comparison_Operators。

• 简化的语法。 若要启用精简语法， Where-Object 请包含 31 个表示比较运算符的开关参数。 简化的语法比脚本块语法更易于读取和写入。 可以将其中一个开关参数与 Property 和 Value 参数组合在一起，以创建一个命令，以便根据对象的属性值筛选对象。

  例如，以下命令还获取具有优先级类 Normal的进程。 这些命令是等效的，可以互换使用它们。

  Get-Process | Where-Object -Property PriorityClass -Value Normal -EQ

  Get-Process | Where-Object PriorityClass -EQ Normal

  如示例中所示，参数名称 “属性 ”和 “值 ”是可选的。 Property 参数是映射到位置的位置0参数。 Value 参数是映射到位置的位置1参数。 用于指定比较的 switch 参数可用于任何位置。

  Windows PowerShell 3.0 中引入了简化的语法。 有关详细信息，请参阅 about_Simplified_Syntax。

将单个属性提供给该属性Where-Object时，该 cmdlet 会将属性的值视为布尔表达式。 当属性的 Length 值不为零时，表达式的计算结果为 $true。 例如：('hi', '', 'there') | Where-Object Length

前面的示例在功能上等效于：

• ('hi', '', 'there') | Where-Object Length -GT 0
• ('hi', '', 'there') | Where-Object { $_.Length -gt 0 }

有关 PowerShell 如何评估布尔值的详细信息，请参阅 about_Booleans。

这些命令获取已停止的所有服务的列表。 $_ 自动变量表示传递给 Where-Object cmdlet 的每个对象。

第一个命令使用脚本块格式，第二个命令使用比较语句格式。 这些命令以相同的方式筛选服务并返回相同的输出。 只有语法不同。

Get-Service | Where-Object { $_.Status -eq "Stopped" }
Get-Service | Where-Object Status -EQ "Stopped"

这些命令列出工作集大于 250 兆字节（MB）的进程。 这些命令按相同的方式筛选进程并返回相同的输出。 只有语法不同。

Get-Process | Where-Object { $_.WorkingSet -gt 250MB }
Get-Process | Where-Object WorkingSet -GT 250MB

这些命令获取以字母 开头的 p 属性值的进程。 运算符 -match 和 Match 参数允许使用正则表达式匹配项。

这些命令按相同的方式筛选进程并返回相同的输出。 只有语法不同。

Get-Process | Where-Object { $_.ProcessName -match "^p.*" }
Get-Process | Where-Object ProcessName -Match "^p.*"

此示例演示如何使用 Where-Object cmdlet 的新比较语句格式。

第一个命令使用比较语句格式。 它不使用任何别名，并且包括每个参数的名称。

第二个命令是比较命令格式的更自然的使用。 该命令将 where 别名替换为 Where-Object cmdlet 名称，并省略所有可选参数名称。

这些命令按相同的方式筛选进程并返回相同的输出。 只有语法不同。

Get-Process | Where-Object -Property Handles -GE -Value 1000
Get-Process | where Handles -GE 1000

此示例演示如何编写返回为 true 或 false 或具有指定属性的任何值的项的命令。 每个示例都显示了命令的脚本块和比较语句格式。

命令按相同的方式筛选输入，并返回相同的输出。 只有语法不同。

# Use Where-Object to get commands that have any value for the OutputType
# property of the command. This omits commands that do not have an OutputType
# property and those that have an OutputType property, but no property value.
Get-Command | Where-Object OutputType
Get-Command | Where-Object { $_.OutputType }

# Use Where-Object to get objects that are containers. This gets objects that
# have the **PSIsContainer** property with a value of $true and excludes all
# others.
Get-ChildItem | Where-Object PSIsContainer
Get-ChildItem | Where-Object { $_.PSIsContainer }

# Finally, use the -not operator (!) to get objects that are not containers.
# This gets objects that do have the **PSIsContainer** property and those
# that have a value of $false for the **PSIsContainer** property.
Get-ChildItem | Where-Object -Not PSIsContainer
Get-ChildItem | Where-Object { !$_.PSIsContainer }

Get-Module -ListAvailable | Where-Object {
    ($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri
}

此示例演示如何创建具有多个条件的 Where-Object 命令。

此命令获取支持可更新帮助功能的非核心模块。 该命令使用 cmdlet 的 Get-Module 参数来获取计算机上的所有模块。 管道运算符 （|） 将模块发送到 Where-Object cmdlet，该 cmdlet 获取名称不以 Microsoft 或 PS开头的模块，并具有 HelpInfoURI 属性的值，该属性指示 PowerShell 在何处查找模块的更新帮助文件。 -and 逻辑运算符连接比较语句。

此示例使用脚本块命令格式。 逻辑运算符（如 -and、-or和 -not）仅在脚本块中有效。 不能在 Where-Object 命令的比较语句格式中使用它们。

• 有关 PowerShell 逻辑运算符的详细信息，请参阅 about_Logical_Operators。
• 有关可更新帮助功能的详细信息，请参阅 about_Updatable_Help。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

你可以通过管道将任何对象传递给此 cmdlet。

此 cmdlet 返回输入对象集中的选定项。

PowerShell 包含以下与 Where-Object相关的别名：

• 所有平台：
  • ?
  • where

从 Windows PowerShell 4.0 开始，添加了用于集合的 Where 和 ForEach 方法。

可以在此处阅读有关这些方法的详细信息 ，about_Arrays