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>]
    [-InputObject <PSObject>]
    [-LE]
    [<CommonParameters>]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  例如，以下命令获取 Normal 优先级类中的进程，即 PriorityClass 属性的值等于 Normal 的进程。

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

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

• 比较语句。 还可以编写比较语句，这更像是自然语言。 Windows PowerShell 3.0 中引入了比较语句。

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

  Get-Process | Where-Object -Property PriorityClass -eq -Value "Normal"

  Get-Process | Where-Object PriorityClass -eq "Normal"

  从 Windows PowerShell 3.0 开始，Where-Object 在 Where-Object 命令中添加比较运算符作为参数。 除非指定，否则所有运算符都区分大小写。 在 Windows PowerShell 3.0 之前，PowerShell 语言中的比较运算符只能在脚本块中使用。

这些命令获取当前已停止的所有服务的列表。

$_ 自动变量表示传递给 Where-Object cmdlet 的每个对象。

第一个命令使用脚本块格式，第二个命令使用比较语句格式。

这些命令是等效的，可以互换使用。

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

这些命令列出工作集大于 25,000 KB（KB）的工作集的进程。 由于 WorkingSet 属性的值以字节为单位存储，因此值 25,000 乘以 1,024。

scriptblock 和语句语法是等效的，可以互换使用。

Get-Process | Where-Object {$_.WorkingSet -GT 25000*1024}
Get-Process | Where-Object WorkingSet -GT (25000*1024)

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

scriptblock 和语句语法是等效的，可以互换使用。

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

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

第一个命令使用比较语句格式。 在此命令中，不使用别名，所有参数都包含参数名称。

第二个命令是比较命令格式的更自然的使用。 别名替换为 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 OutputType
Get-Command | where {$_.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 PSIsContainer
Get-ChildItem | where {$_.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 {!$_.PSIsContainer}
# You cannot use the Not operator (!) in the comparison statement format of the command.
Get-ChildItem | where PSIsContainer -eq $False

Get-Module -ListAvailable | where {($_.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）仅在脚本块中有效。 不能在 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 从输入对象集中返回选定的项。

• 从 Windows PowerShell 4.0 开始，添加了用于集合的 Where 和 ForEach 方法。
  • 可以在此处阅读有关这些新方法的详细信息，about_arrays