Where-Object

Ссылка

Модуль:: Microsoft.PowerShell.Core

Выбирает объекты из коллекции на основании значения их свойств.

Синтаксис

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Описание

Командлет Where-Object выбирает объекты с определенными значениями свойств из коллекции объектов, передаваемых в него. Например, можно использовать Where-Object командлет для выбора файлов, созданных после определенной даты, событий с определенным идентификатором или компьютеров, использующих определенную версию 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значение свойства обрабатывается как логическое выражение. Если значение Length не равно нулю, выражение принимает значение True. Пример: ('hi', '', 'there') | Where-Object Length

Предыдущий пример функционально эквивалентен следующим:

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

Примеры

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

Эти команды получают список всех служб, которые в настоящее время остановлены. Автоматическая $_ переменная представляет каждый объект, передаваемый командлету Where-Object .

Первая команда использует формат блока скрипта, вторая команда использует формат оператора сравнения. Команды эквивалентны и взаимозаменяемы.

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

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

Эти команды перечисляют процессы с рабочим набором размером более 250 мб (КБ). Синтаксис скрипта и оператора эквивалентен и может использоваться взаимозаменяемо.

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

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

Эти команды получают процессы со значением свойства ProcessName , начинающимся с буквы p. Оператор Match позволяет использовать совпадения регулярных выражений.

Синтаксис скрипта и оператора эквивалентен и может использоваться взаимозаменяемо.

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

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

В этом примере показано, как использовать новый формат инструкции сравнения командлета Where-Object .

Вторая команда использует формат оператора сравнения. В этой команде не используются псевдонимы, и все параметры включают имя параметра.

Вторая команда является более естественным способом использованием формата команды сравнения. Псевдоним where заменяется именем командлета Where-Object , а все необязательные имена параметров опущены.

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

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

В этом примере показано, как написать команды, которые возвращают элементы, имеющие значения 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

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

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

В этом примере показано, как создать Where-Object команду с несколькими условиями.

Эта команда получает вспомогательные модули, которые поддерживают функцию обновляемой справки. Команда использует параметр ListAvailable командлета Get-Module для получения всех модулей на компьютере. Оператор конвейера (|) отправляет модули Where-Object в командлет, который получает модули, имена которых не начинаются с Microsoft или PS, и имеют значение для свойства HelpInfoURI , которое сообщает PowerShell, где найти обновленные файлы справки для модуля. Оператор сравнения соединен логическим оператором And .

В примере используется формат команды блока сценария. Логические операторы, такие как And and Or, допустимы только в блоках скриптов. Их нельзя использовать в формате инструкции Where-Object сравнения команды.

Дополнительные сведения о логических операторах PowerShell см. в about_Logical_Operators.
Дополнительные сведения о функции обновляемой справки см. в about_Updatable_Help.

Параметры

-CContains

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

Пример: Get-Process | where ProcessName -CContains "svchost"

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CEQ

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CGE

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CGT

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CIn

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

Пример: Get-Process | where -Value "svchost" -CIn ProcessName

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

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CLE

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CLike

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

Пример: Get-Process | where ProcessName -CLike "*host"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CLT

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CMatch

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

Пример: Get-Process | where ProcessName -CMatch "Shell"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CNE

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CNotContains

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

Пример: Get-Process | where ProcessName -CNotContains "svchost"

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CNotIn

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

Пример: Get-Process | where -Value "svchost" -CNotIn -Property ProcessName

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CNotLike

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

Пример: Get-Process | where ProcessName -CNotLike "*host"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CNotMatch

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

Пример: Get-Process | where ProcessName -CNotMatch "Shell"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Contains

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

Пример: Get-Process | where ProcessName -Contains "Svchost"

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

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

Type:	SwitchParameter
Aliases:	IContains
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EQ

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

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

Type:	SwitchParameter
Aliases:	IEQ
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilterScript

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

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

Type:	ScriptBlock
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GE

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

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

Type:	SwitchParameter
Aliases:	IGE
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GT

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

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

Type:	SwitchParameter
Aliases:	IGT
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-In

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

Get-Process | where -Property ProcessName -in -Value "Svchost", "TaskHost", "WsmProvHost"

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

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

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

Type:	SwitchParameter
Aliases:	IIn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Задает объекты для фильтрации. Вы также можете передать объекты в Where-Object.

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

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Is

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-IsNot

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LE

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

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

Type:	SwitchParameter
Aliases:	ILE
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Like

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

Пример: Get-Process | where ProcessName -Like "*host"

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

Type:	SwitchParameter
Aliases:	ILike
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LT

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

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

Type:	SwitchParameter
Aliases:	ILT
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Match

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

Пример: Get-Process | where ProcessName -Match "shell"

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

Type:	SwitchParameter
Aliases:	IMatch
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NE

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

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

Type:	SwitchParameter
Aliases:	INE
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Not

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

Пример: Get-Service | where -Not "DependentServices"

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotContains

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

Пример: Get-Process | where ProcessName -NotContains "Svchost"

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

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

Type:	SwitchParameter
Aliases:	INotContains
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotIn

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

Пример: Get-Process | where -Value "svchost" -NotIn -Property ProcessName

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

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

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

Type:	SwitchParameter
Aliases:	INotIn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotLike

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

Пример: Get-Process | where ProcessName -NotLike "*host"

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

Type:	SwitchParameter
Aliases:	INotLike
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotMatch

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

Пример: Get-Process | where ProcessName -NotMatch "PowerShell"

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

Type:	SwitchParameter
Aliases:	INotMatch
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Задает имя свойства объекта. Имя параметра, свойство, является необязательным.

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

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

CLike
CNotLike
Как
NotLike

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

Type:	Object
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

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

PSObject

Объекты можно передать в этот командлет.

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

Object

Этот командлет возвращает выбранные элементы из набора входных объектов.

Примечания

Начиная с версии Windows PowerShell 4.0Where, были ForEach добавлены методы для использования с коллекциями.

Дополнительные сведения об этих новых методах см. здесь about_arrays

Where-Object

Синтаксис

Описание

Примеры

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

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

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

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

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

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

Параметры

-CContains

-CEQ

-CGE

-CGT

-CIn

-CLE

-CLike

-CLT

-CMatch

-CNE

-CNotContains

-CNotIn

-CNotLike

-CNotMatch

-Contains

-EQ

-FilterScript

-GE

-GT

-In

-InputObject

-Is

-IsNot

-LE

-Like

-LT

-Match

-NE

-Not

-NotContains

-NotIn

-NotLike

-NotMatch

-Property

-Value

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

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

Примечания

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

Дополнительные ресурсы