Where-Object

Синтаксис

EqualSet (по умолчанию)

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

ScriptBlockSet

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

MatchSet

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

CaseSensitiveEqualSet

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

NotEqualSet

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

CaseSensitiveNotEqualSet

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

GreaterThanSet

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

CaseSensitiveGreaterThanSet

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

LessThanSet

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

CaseSensitiveLessThanSet

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

GreaterOrEqualSet

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

CaseSensitiveGreaterOrEqualSet

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

LessOrEqualSet

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

CaseSensitiveLessOrEqualSet

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

LikeSet

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

CaseSensitiveLikeSet

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

NotLikeSet

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

CaseSensitiveNotLikeSet

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

CaseSensitiveMatchSet

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

NotMatchSet

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

CaseSensitiveNotMatchSet

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

ContainsSet

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

CaseSensitiveContainsSet

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

NotContainsSet

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

CaseSensitiveNotContainsSet

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

InSet

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

CaseSensitiveInSet

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

NotInSet

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

CaseSensitiveNotInSet

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

IsSet

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

IsNotSet

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

Not

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

Описание

Примеры

Пример 1. Получение остановленных служб

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

Пример 2. Получение процессов на основе рабочего набора

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

Пример 3. Получение процессов на основе имени процесса

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

Пример 4. Использование формата инструкции сравнения

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

Пример 5. Получение команд на основе свойств

# 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 }

Пример 6. Использование нескольких условий

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

Параметры

-CContains

Указывает, что этот командлет получает объекты из коллекции, если значение свойства объекта является точным совпадением с указанным значением. Эта операция учитывает регистр.

Например: Get-Process | Where-Object ProcessName -CContains "svchost"

CContains ссылается на коллекцию значений и имеет значение true, если коллекция содержит элемент, который является точным совпадением с указанным значением. Если входные данные являются одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CEQ

Указывает, что этот командлет получает объекты, если значение свойства совпадает с указанным значением. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CGE

Указывает, что этот командлет получает объекты, если значение свойства больше или равно указанному значению. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CGT

Указывает, что этот командлет получает объекты, если значение свойства больше указанного значения. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CIn

Указывает, что этот командлет получает объекты, если значение свойства содержит указанное значение. Эта операция учитывает регистр.

Например: Get-Process | Where-Object -Value "svchost" -CIn ProcessName

CIn напоминает CContains, за исключением того, что позиции свойств и значений возвращаются обратно. Например, следующие инструкции являются истинными.

"abc", "def" -CContains "abc"

"abc" -CIn "abc", "def"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CLE

Указывает, что этот командлет получает объекты, если значение свойства меньше или равно указанному значению. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CLike

Указывает, что этот командлет получает объекты, если значение свойства соответствует значению, включающее подстановочные знаки (*). Эта операция учитывает регистр.

Например: Get-Process | Where-Object ProcessName -CLike "*host"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CLT

Указывает, что этот командлет получает объекты, если значение свойства меньше указанного значения. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CMatch

Указывает, что этот командлет получает объекты, если значение свойства соответствует указанному регулярному выражению. Эта операция учитывает регистр. Если входные данные являются одним объектом, соответствующее значение сохраняется в $Matches автоматической переменной.

Например: Get-Process | Where-Object ProcessName -CMatch "Shell"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CNE

Указывает, что этот командлет получает объекты, если значение свойства отличается от указанного значения. Эта операция учитывает регистр.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CNotContains

Указывает, что этот командлет получает объекты, если значение свойства объекта не совпадает с указанным значением. Эта операция учитывает регистр.

Например: Get-Process | Where-Object ProcessName -CNotContains "svchost"

NotContains и CNotContains ссылаются на коллекцию значений и имеют значение true, если коллекция не содержит никаких элементов, которые точно соответствуют указанному значению. Если входные данные являются одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CNotIn

Указывает, что этот командлет получает объекты, если значение свойства не совпадает с указанным значением. Эта операция учитывает регистр.

Например: Get-Process | Where-Object -Value "svchost" -CNotIn -Property ProcessName

Операторы NotIn и CNotIn похожи на NotContains и CNotContains, за исключением того, что позиции свойств и значений возвращаются обратно. Например, приведенные ниже инструкции имеют значение true.

"abc", "def" -CNotContains "Abc"

"abc" -CNotIn "Abc", "def"

Свойства параметра

Наборы параметров

-CNotLike

Указывает, что этот командлет получает объекты, если значение свойства не соответствует значению, включающее подстановочные знаки. Эта операция учитывает регистр.

Например: Get-Process | Where-Object ProcessName -CNotLike "*host"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-CNotMatch

Указывает, что этот командлет получает объекты, если значение свойства не соответствует указанному регулярному выражению. Эта операция учитывает регистр. Если входные данные являются одним объектом, соответствующее значение сохраняется в $Matches автоматической переменной.

Например: Get-Process | Where-Object ProcessName -CNotMatch "Shell"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Contains

Указывает, что этот командлет получает объекты, если любой элемент в значении свойства объекта является точным совпадением с указанным значением.

Например: Get-Process | Where-Object ProcessName -Contains "Svchost"

Если входные данные являются одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-EQ

Указывает, что этот командлет получает объекты, если значение свойства совпадает с указанным значением.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-FilterScript

Задает блок скрипта, используемый для фильтрации объектов. Заключите блок скрипта в фигурные скобки ({}).

Имя параметра, FilterScript, является необязательным.

Свойства параметра

Наборы параметров

-GE

Указывает, что этот командлет получает объекты, если значение свойства больше или равно указанному значению.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-GT

Указывает, что этот командлет получает объекты, если значение свойства больше указанного значения.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-In

Указывает, что этот командлет получает объекты, если значение свойства соответствует любому из указанных значений. Рассмотрим пример.

Get-Process | Where-Object -Property ProcessName -In -Value "Svchost", "TaskHost", "WsmProvHost"

Если входные данные являются одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Если значение свойства объекта является массивом, PowerShell использует равенство ссылок для определения соответствия. Where-Object возвращает объект, только если значение параметра Property и любое значение Value являются одинаковым экземпляром объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-InputObject

Указывает объекты для фильтрации. Можно также передать объекты в Where-Object.

При использовании параметра Where-ObjectWhere-Objectвместо командлет обрабатывает InputObject как один объект. Это верно, даже если значение является коллекцией, которая является результатом команды, например -InputObject (Get-Process).

Так как InputObject не может возвращать отдельные свойства из массива или коллекции объектов, рекомендуется фильтровать коллекцию объектов для тех объектов, которые имеют определенные значения в определенных свойствах, которые используются Where-ObjectWhere-Object в конвейере, как показано в примерах в этом разделе.

Свойства параметра

Наборы параметров

-Is

Указывает, что этот командлет получает объекты, если значение свойства является экземпляром указанного типа .NET. Заключите имя типа в квадратные скобки.

Например: Get-Process | Where-Object StartTime -Is [datetime]

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-IsNot

Указывает, что этот командлет получает объекты, если значение свойства не является экземпляром указанного типа .NET.

Например: Get-Process | where StartTime -IsNot [datetime]

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-LE

Указывает, что этот командлет получает объекты, если значение свойства меньше или равно указанному значению.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Like

Указывает, что этот командлет получает объекты, если значение свойства соответствует значению, включающее подстановочные знаки (*).

Например: Get-Process | Where-Object ProcessName -Like "*host"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-LT

Указывает, что этот командлет получает объекты, если значение свойства меньше указанного значения.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Match

Указывает, что этот командлет получает объекты, если значение свойства соответствует указанному регулярному выражению. Если входные данные являются одним объектом, соответствующее значение сохраняется в $Matches автоматической переменной.

Например: Get-Process | Where-Object ProcessName -Match "shell"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-NE

Указывает, что этот командлет получает объекты, если значение свойства отличается от указанного значения.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Not

Указывает, что этот командлет получает объекты, если свойство не существует или имеет значение $null или $false.

Например: Get-Service | Where-Object -Not "DependentServices"

Этот параметр появился в Windows PowerShell 6.1.

Свойства параметра

Наборы параметров

-NotContains

Указывает, что этот командлет получает объекты, если ни один из элементов в значении свойства не соответствует точному значению указанного значения.

Например: Get-Process | Where-Object ProcessName -NotContains "Svchost"

NotContains ссылается на коллекцию значений и имеет значение true, если коллекция не содержит никаких элементов, которые точно соответствуют указанному значению. Если входные данные являются одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-NotIn

Указывает, что этот командлет получает объекты, если значение свойства не соответствует ни одному из указанных значений.

Например: Get-Process | Where-Object -Value "svchost" -NotIn -Property ProcessName

Если значение Value является одним объектом, PowerShell преобразует его в коллекцию одного объекта.

Если значение свойства объекта является массивом, PowerShell использует равенство ссылок для определения соответствия. Where-Object возвращает объект, только если значение свойства и любое значение Value не совпадает с экземпляром объекта.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-NotLike

Указывает, что этот командлет получает объекты, если значение свойства не соответствует значению, включающее подстановочные знаки (*).

Например: Get-Process | Where-Object ProcessName -NotLike "*host"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-NotMatch

Указывает, что этот командлет получает объекты, если значение свойства не соответствует указанному регулярному выражению. Если входные данные являются одним объектом, соответствующее значение сохраняется в $Matches автоматической переменной.

Например: Get-Process | Where-Object ProcessName -NotMatch "powershell"

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Property

Указывает имя свойства входного объекта. Это свойство должно быть свойством экземпляра, а не статическим. Это позиционный параметр, поэтому имя, свойство, является необязательным.

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

-Value

Указывает значение свойства. Имя параметра, значение, является необязательным. Этот параметр принимает подстановочные знаки при использовании со следующими параметрами сравнения:

• Клике
• CNotLike
• Like
• NotLike

Этот параметр появился в Windows PowerShell 3.0.

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

PSObject

Выходные данные

Object

Примечания

Связанные ссылки

• Сравнить-Объект
• ForEach-Object
• Группировка-Объектов
• Measure-Object
• Новый объект
• Select-Object (Выбор объекта)
• Сортировка объекта
• Tee-Object
• about_Booleans