Where-Object
Выбирает объекты из коллекции на основании значения их свойств.
Синтаксис
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>]
[-LE]
[<CommonParameters>]
Where-Object
[-InputObject <PSObject>]
[-Property] <String>
[[-Value] <Object>]
[-CGE]
[<CommonParameters>]
Where-Object
[-InputObject <PSObject>]
[-Property] <String>
[[-Value] <Object>]
[-CLE]
[<CommonParameters>]
Where-Object
[-InputObject <PSObject>]
[-Property] <String>
[[-Value] <Object>]
[-CIn]
[<CommonParameters>]
Where-Object
[-InputObject <PSObject>]
[-Property] <String>
[[-Value] <Object>]
[-GE]
[<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>]
[-Like]
[<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>
[[-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
выбирает объекты с определенными значениями свойств из коллекции объектов, передаваемых ему.
Например, командлет можно использовать для 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 можно было использовать только в блоках скриптов.
Примеры
Пример 1. Получение остановленных служб
Эти команды получают список всех служб, которые в настоящее время остановлены.
Автоматическая $_
переменная представляет каждый объект, передаваемый командлету Where-Object
.
Первая команда использует формат блока скрипта, вторая — формат инструкции сравнения.
Команды эквивалентны и взаимозаменяемы.
Get-Service | Where-Object {$_.Status -eq "Stopped"}
Get-Service | where Status -eq "Stopped"
Пример 2. Получение процессов на основе рабочего набора
Эти команды перечисляют процессы с рабочим набором более 25 000 килобайт (КБ). Так как значение свойства WorkingSet хранится в байтах, значение 25 000 умножается на 1024.
Синтаксис scriptblock и оператора эквивалентен и может использоваться взаимозаменяемо.
Get-Process | Where-Object {$_.WorkingSet -GT 25000*1024}
Get-Process | Where-Object WorkingSet -GT (25000*1024)
Пример 3. Получение процессов на основе имени процесса
Эти команды получают процессы, имеющие значение свойства ProcessName , начинающееся с буквы p. Оператор Match позволяет использовать совпадения регулярных выражений.
Синтаксис scriptblock и оператора эквивалентен и может использоваться взаимозаменяемо.
Get-Process | Where-Object {$_.ProcessName -Match "^p.*"}
Get-Process | Where-Object ProcessName -Match "^p.*"
Пример 4. Использование формата инструкции сравнения
В этом примере показано, как использовать новый формат инструкции сравнения командлета Where-Object
.
Вторая команда использует формат оператора сравнения. В этой команде не используются псевдонимы, и все параметры включают имя параметра.
Вторая команда является более естественным способом использованием формата команды сравнения.
, где псевдоним заменяется именем командлета 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 и 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"
Оператор "не содержит" (с учетом регистра и без) относится к коллекции значений и справедлив, если коллекция не содержит элементы, являющиеся точным соответствием для указанного значения. Если входные данные являются одним объектом, 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 (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 Framework. Заключите имя типа в квадратные скобки.
Например 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 Framework.
Например 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 |
-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
Задает имя свойства объекта.
Имя параметра Property является необязательным.
Этот параметр впервые появился в Windows PowerShell 3.0.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Задает значение свойства. Имя параметра 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 |
Входные данные
Объекты можно передать в этот командлет.
Выходные данные
Object
Этот командлет возвращает выбранные элементы из входного набора объектов.
Примечания
- Начиная с Windows PowerShell 4.0,
Where
методы иForEach
были добавлены для использования с коллекциями.- Дополнительные сведения об этих новых методах см. здесь about_arrays