Select-Object

Ссылка

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

Выбирает объекты или свойства объектов.

Синтаксис

Select-Object
      [-InputObject <PSObject>]
      [[-Property] <Object[]>]
      [-ExcludeProperty <String[]>]
      [-ExpandProperty <String>]
      [-Unique]
      [-CaseInsensitive]
      [-Last <Int32>]
      [-First <Int32>]
      [-Skip <Int32>]
      [-Wait]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [[-Property] <Object[]>]
      [-ExcludeProperty <String[]>]
      [-ExpandProperty <String>]
      [-Unique]
      [-CaseInsensitive]
      [-Skip <Int32>]
      [-SkipLast <Int32>]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [-Unique]
      [-CaseInsensitive]
      [-Wait]
      [-Index <Int32[]>]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [-Unique]
      [-CaseInsensitive]
      [-SkipIndex <Int32[]>]
      [<CommonParameters>]

Описание

Командлет Select-Object выбирает указанные свойства объекта или набора объектов. Он также может выбирать уникальные объекты, указанное число объектов или объекты в указанной позиции в массиве.

Чтобы выбрать объекты из коллекции, используйте параметры First, Last, Unique, Skip и Index. Чтобы выбрать свойства объекта, используйте параметр Property . При выборе свойств Select-Object возвращает новые объекты, имеющие только указанные свойства.

Начиная с Windows PowerShell 3.0, включает функцию оптимизации, Select-Object которая предотвращает создание и обработку объектов, которые не используются.

При использовании Select-Objectпараметров First или Index в командном конвейере PowerShell останавливает команду, которая создает объекты сразу после достижения выбранного числа объектов. Чтобы отключить это поведение оптимизации, используйте параметр Wait .

Примеры

Пример 1. Выбор объектов по свойству

В этом примере создаются объекты с свойствами Name, ID и рабочих наборов (WS) объектов процесса.

Get-Process | Select-Object -Property ProcessName, Id, WS

Пример 2. Выбор объектов по свойству и форматирование результатов

В этом примере показано, как получить сведения о модулях, используемых процессами на компьютере. Он использует Get-Process командлет для получения процесса на компьютере.

Он использует Select-Object командлет для вывода массива [System.Diagnostics.ProcessModule] экземпляров, содержащихся в свойстве Modules каждого System.Diagnostics.Process выходного экземпляра Get-Process.

Параметр Select-Object свойства командлета выбирает имена процессов. Это добавляет ProcessNameNoteProperty к каждому [System.Diagnostics.ProcessModule] экземпляру и заполняет его значением свойства ProcessName текущего процесса.

Наконец, Format-List командлет используется для отображения имени и модулей каждого процесса в списке.

Get-Process Explorer |
    Select-Object -Property ProcessName -ExpandProperty Modules |
    Format-List

ProcessName       : explorer
ModuleName        : explorer.exe
FileName          : C:\WINDOWS\explorer.exe
BaseAddress       : 140697278152704
ModuleMemorySize  : 3919872
EntryPointAddress : 140697278841168
FileVersionInfo   : File:             C:\WINDOWS\explorer.exe
                    InternalName:     explorer
                    OriginalFilename: EXPLORER.EXE.MUI
                    FileVersion:      10.0.17134.1 (WinBuild.160101.0800)
                    FileDescription:  Windows Explorer
                    Product:          Microsoft Windows Operating System
                    ProductVersion:   10.0.17134.1
...

Пример 3. Выбор процессов с использованием большей памяти

В этом примере получается пять процессов, использующих большую память. Командлет Get-Process получает процессы на компьютере. Командлет Sort-Object сортирует процессы в соответствии с использованием памяти (рабочий набор), а Select-Object командлет выбирает только последние пять членов результирующего массива объектов.

Параметр Wait не требуется в командах, которые включают Sort-Object командлет, так как Sort-Object обрабатывает все объекты, а затем возвращает коллекцию. Оптимизация Select-Object доступна только для команд, возвращающих объекты по отдельности по мере их обработки.

Get-Process | Sort-Object -Property WS | Select-Object -Last 5

Handles  NPM(K)    PM(K)      WS(K) VS(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
2866     320       33432      45764   203   222.41   1292 svchost
577      17        23676      50516   265    50.58   4388 WINWORD
826      11        75448      76712   188    19.77   3780 Ps
1367     14        73152      88736   216    61.69    676 Ps
1612     44        66080      92780   380   900.59   6132 INFOPATH

Пример 4. Выбор уникальных символов из массива

В этом примере используется уникальный параметр Select-Object для получения уникальных символов из массива символов.

"a","b","c","a","A","a" | Select-Object -Unique

a
b
c
A

Пример 5. Использование "-Unique" с другими параметрами

Значения уникальных параметров фильтруются после применения других Select-Object параметров. Например, если для выбора первого числа элементов в массиве используется первый параметр, уникально применяется только к выбранным значениям, а не ко всему массиву.

"a","a","b","c" | Select-Object -First 2 -Unique

a

В этом примере сначала выбирается "a","a" в качестве первых 2 элементов в массиве. Уникальный применяется к "a","a" и возвращается a в качестве уникального значения.

Пример 6. Выбор уникальных строк с помощью параметра -CaseInsensitive

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

"aa", "Aa", "Bb", "bb" | Select-Object -Unique -CaseInsensitive

aa
Bb

Пример 7. Выбор новых и старейших событий в журнале событий

Этот пример получает первые (новейшие) и последние (старые) события в журнале событий Windows PowerShell.

Get-WinEvent получает все события в журнале Windows PowerShell и сохраняет их в переменной $a . $a Затем он будет передан командлетуSelect-Object. Команда Select-Object использует параметр Index для выбора событий из массива событий в переменной $a. Индекс первого события равен 0. Индекс последнего события — это число элементов минус $a 1.

$a = Get-WinEvent -LogName "Windows PowerShell"
$a | Select-Object -Index 0, ($a.count - 1)

Пример 8. Выберите все, кроме первого объекта

В этом примере создается новая функция PSSession на каждом из компьютеров, перечисленных в файлах Servers.txt, за исключением первого.

Select-Object выбирает все, кроме первого компьютера в списке имен компьютеров. Результирующий список компьютеров задается в качестве значения параметра ComputerName командлета New-PSSession .

New-PSSession -ComputerName (Get-Content Servers.txt | Select-Object -Skip 1)

Пример 9. Переименование файлов и выбор нескольких для проверки

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

Get-ChildItem использует динамический параметр ReadOnly для получения файлов только для чтения. Полученные файлы передаются командлету Rename-Item , который переименовывает файл. Он использует параметр PassThru для Rename-Item отправки переименованных файлов Select-Object командлету, который выбирает первую 5 для отображения.

Параметр Select-Object wait предотвращает остановку Get-ChildItem командлета PowerShell после того, как он получает первые пять текстовых файлов только для чтения. Без этого параметра были бы переименованы только первые пять таких файлов.

Get-ChildItem *.txt -ReadOnly |
    Rename-Item -NewName {$_.BaseName + "-ro.txt"} -PassThru |
    Select-Object -First 5 -Wait

Пример 10. Отображение сведений о параметре -ExpandProperty

В этом примере показаны тонкости параметра ExpandProperty .

Обратите внимание, что выходные данные были массивом экземпляров [System.Int32] . Экземпляры соответствуют стандартным правилам форматирования представления вывода. Это верно для любых расширенных свойств. Если выходные объекты имеют определенный стандартный формат, развернутое свойство может не отображаться.

# Create a custom object to use for the Select-Object example.
$object = [pscustomobject]@{Name="CustomObject";Expand=@(1,2,3,4,5)}
# Use the ExpandProperty parameter to Expand the property.
$object | Select-Object -ExpandProperty Expand -Property Name

1
2
3
4
5

# The output did not contain the Name property, but it was added successfully.
# Use Get-Member to confirm the Name property was added and populated.
$object | Select-Object -ExpandProperty Expand -Property Name | Get-Member

TypeName: System.Int32

Name        MemberType   Definition
----        ----------   ----------
CompareTo   Method       int CompareTo(System.Object value), int CompareTo(int value), ...
Equals      Method       bool Equals(System.Object obj), bool Equals(int obj), bool IEq...
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
GetTypeCode Method       System.TypeCode GetTypeCode(), System.TypeCode IConvertible.Ge...
ToBoolean   Method       bool IConvertible.ToBoolean(System.IFormatProvider provider)
ToByte      Method       byte IConvertible.ToByte(System.IFormatProvider provider)
ToChar      Method       char IConvertible.ToChar(System.IFormatProvider provider)
ToDateTime  Method       datetime IConvertible.ToDateTime(System.IFormatProvider provider)
ToDecimal   Method       decimal IConvertible.ToDecimal(System.IFormatProvider provider)
ToDouble    Method       double IConvertible.ToDouble(System.IFormatProvider provider)
ToInt16     Method       int16 IConvertible.ToInt16(System.IFormatProvider provider)
ToInt32     Method       int IConvertible.ToInt32(System.IFormatProvider provider)
ToInt64     Method       long IConvertible.ToInt64(System.IFormatProvider provider)
ToSByte     Method       sbyte IConvertible.ToSByte(System.IFormatProvider provider)
ToSingle    Method       float IConvertible.ToSingle(System.IFormatProvider provider)
ToString    Method       string ToString(), string ToString(string format), string ToS...
ToType      Method       System.Object IConvertible.ToType(type conversionType, System...
ToUInt16    Method       uint16 IConvertible.ToUInt16(System.IFormatProvider provider)
ToUInt32    Method       uint32 IConvertible.ToUInt32(System.IFormatProvider provider)
ToUInt64    Method       uint64 IConvertible.ToUInt64(System.IFormatProvider provider)
Name        NoteProperty string Name=CustomObject

Пример 11. Создание настраиваемых свойств для объектов

В следующем примере показано, как Select-Object добавить пользовательское свойство в любой объект. При указании имени свойства, которое не существует, Select-Object создает это свойство как NoteProperty для каждого переданного объекта.

$customObject = 1 | Select-Object -Property MyCustomProperty
$customObject.MyCustomProperty = "New Custom Property"
$customObject

MyCustomProperty
----------------
New Custom Property

Пример 12. Создание вычисляемых свойств для каждого объекта InputObject

В этом примере показано, как Select-Object добавить вычисляемые свойства в входные данные. Передача ScriptBlock параметру Property приводит Select-Object к оценке выражения для каждого объекта, передаваемого и добавления результатов в выходные данные. В ScriptBlock можно использовать $_ переменную для ссылки на текущий объект в конвейере.

По умолчанию Select-Object в качестве имени свойства используется строка ScriptBlock . С помощью хэш-файла можно пометить выходные данные ScriptBlock как настраиваемое свойство, добавленное к каждому объекту. Вы можете добавить несколько вычисляемых свойств для каждого объекта, переданного Select-Objectв .

# Create a calculated property called $_.StartTime.DayOfWeek
Get-Process | Select-Object -Property ProcessName,{$_.StartTime.DayOfWeek}

ProcessName  $_.StartTime.DayOfWeek
----         ----------------------
alg                       Wednesday
ati2evxx                  Wednesday
ati2evxx                   Thursday
...

# Add a custom property to calculate the size in KiloBytes of each FileInfo
# object you pass in. Use the pipeline variable to divide each file's length by
# 1 KiloBytes
$size = @{label="Size(KB)";expression={$_.length/1KB}}
# Create an additional calculated property with the number of Days since the
# file was last accessed. You can also shorten the key names to be 'l', and 'e',
# or use Name instead of Label.
$days = @{l="Days";e={((Get-Date) - $_.LastAccessTime).Days}}
# You can also shorten the name of your label key to 'l' and your expression key
# to 'e'.
Get-ChildItem $PSHOME -File | Select-Object Name, $size, $days

Name                        Size(KB)        Days
----                        --------        ----
Certificate.format.ps1xml   12.5244140625   223
Diagnostics.Format.ps1xml   4.955078125     223
DotNetTypes.format.ps1xml   134.9833984375  223

Пример 13. Выбор хэш-ключей без использования вычисляемых свойств

Начиная с PowerShell 6, Select-Object поддерживает выбор ключей хэшируемых входных данных в качестве свойств. В следующем примере выбираются и name ключи weight для входного хэш-файла и отображаются выходные данные.

@{ name = 'a' ; weight = 7 } | Select-Object -Property name, weight

name weight
---- ------
a         7

Параметры

-CaseInsensitive

По умолчанию при использовании уникального параметра командлет использует сравнения с учетом регистра. При использовании этого параметра командлет использует нечувствительные сравнения регистра.

Этот параметр добавлен в PowerShell 7.4.

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

-ExcludeProperty

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

Начиная с PowerShell 6, больше не требуется включать параметр свойства для функции ExcludeProperty .

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ExpandProperty

Задает свойство, которое нужно выбрать, и указывает, что нужно попытаться расширить его. Если конвейер входного объекта не имеет именованного свойства, Select-Object возвращает ошибку.

Если указанное свойство является массивом, каждое значение массива включается в выходные данные.
Если указанное свойство является объектом, свойства объектов развертываются для каждого Объекта InputObject

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

Если задан параметр Property, Select-Object пытается добавить каждое выбранное свойство в качестве атрибута NoteProperty к каждому выходному объекту.

Предупреждение

Если вы получаете сообщение об ошибке, что свойство не может быть обработано, так как свойство с этим именем уже существует, рассмотрите следующее. Обратите внимание, что при использовании ExpandPropertySelect-Object не удается заменить существующее свойство. Это означает следующее:

Если развернутый объект имеет свойство того же имени, команда возвращает ошибку.
Если объект Selected имеет свойство того же имени, что и свойство развернутого объекта, команда возвращает ошибку.

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

-First

Указывает число объектов, которое нужно выбрать с начала массива входных объектов.

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

-Index

Выбирает объекты из массива в соответствии со значениями индекса. Введите индексы в виде разделенного запятыми списка. Индексы массива начинаются с нуля, то есть 0 представляет первое значение, а (n-1) — последнее значение.

Type:	Int32[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Указывает объекты, которые необходимо передать в командлет по конвейеру. Этот параметр позволяет передавать объекты в Select-Object.

При передаче объектов в параметр InputObject вместо Select-Object использования конвейера обрабатывает InputObject как один объект, даже если значение является коллекцией. Рекомендуется использовать конвейер при передаче коллекций Select-Objectв .

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

-Last

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

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

-Property

Указывает свойства, которые нужно выбрать. Эти свойства добавляются как элементы NoteProperty в выходные объекты. Разрешено использовать подстановочные знаки. Если входной объект не имеет именованного свойства, для нового Объекта NoteProperty задано $nullзначение .

Значение параметра Property может быть новым вычисляемым свойством. Чтобы создать вычисляемое свойство, используйте хэш-таблицу.

Допустимые разделы следующие:

Имя (или метка) — <string>
Выражение — <string> или <script block>

Дополнительные сведения см. в about_Calculated_Properties.

Type:	Object[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Skip

Пропускает (не выбирает) указанное количество элементов. По умолчанию параметр Skip подсчитывается с начала коллекции объектов. Если команда использует последний параметр, он подсчитывается из конца коллекции.

В отличие от параметра Index, который начинает подсчет от 0, параметр Skip начинается с 1.

Начиная с PowerShell 7.4, можно использовать параметр Skip с параметром SkipLast, чтобы пропустить элементы из начала и конца коллекции.

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

-SkipIndex

Пропускает (не выбирает) объекты из массива на основе их значений индекса. Введите индексы в виде разделенного запятыми списка. Индексы массива начинаются с нуля, то есть 0 представляет первое значение, а (n-1) — последнее значение.

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

Type:	Int32[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipLast

Пропускает (не выбирает) указанное количество элементов из конца списка или массива. Работает так же, как использование skip вместе с последним параметром.

В отличие от параметра Index, который начинает подсчет от 0, параметр SkipLast начинается с 1.

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

-Unique

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

Уникальные значения выбираются после применения других параметров фильтрации.

Этот параметр чувствителен к регистру. Поэтому строки, которые отличаются только регистром символов, считаются уникальными. Добавьте параметр CaseInsensitive для выполнения сравнения без учета регистра.

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

-Wait

Указывает, что командлет отключает оптимизацию. PowerShell выполняет команды в том порядке, в котором они отображаются в командном конвейере и позволяют создавать все объекты. По умолчанию при включении Select-Object команды с параметрами First или Index в командном конвейере PowerShell останавливает команду, которая создает объекты сразу после создания выбранного числа объектов.

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

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

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

PSObject

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

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

PSObject

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

Примечания

PowerShell включает следующие псевдонимы для Select-Object:

Все платформы:
- select

Функция Select-Object оптимизации доступна только для команд, которые записывают объекты в конвейер по мере их обработки. Она не действует для команд, которые буферизуют обработанные объекты и записывают их в виде коллекции. При разработке командлетов рекомендуется немедленно записывать объекты. Дополнительные сведения см. в разделе "Запись отдельных записей в конвейер " в строго рекомендуемых рекомендациях по разработке.

Select-Object

Синтаксис

Описание

Примеры

Пример 1. Выбор объектов по свойству

Пример 2. Выбор объектов по свойству и форматирование результатов

Пример 3. Выбор процессов с использованием большей памяти

Пример 4. Выбор уникальных символов из массива

Пример 5. Использование "-Unique" с другими параметрами

Пример 6. Выбор уникальных строк с помощью параметра -CaseInsensitive

Пример 7. Выбор новых и старейших событий в журнале событий

Пример 8. Выберите все, кроме первого объекта

Пример 9. Переименование файлов и выбор нескольких для проверки

Пример 10. Отображение сведений о параметре -ExpandProperty

Пример 11. Создание настраиваемых свойств для объектов

Пример 12. Создание вычисляемых свойств для каждого объекта InputObject

Пример 13. Выбор хэш-ключей без использования вычисляемых свойств

Параметры

-CaseInsensitive

-ExcludeProperty

-ExpandProperty

-First

-Index

-InputObject

-Last

-Property

-Skip

-SkipIndex

-SkipLast

-Unique

-Wait

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

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

Примечания

Обратная связь

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

Select-Object

Синтаксис

Описание

Примеры

Пример 1. Выбор объектов по свойству

Пример 2. Выбор объектов по свойству и форматирование результатов

Пример 3. Выбор процессов с использованием большей памяти

Пример 4. Выбор уникальных символов из массива

Пример 5. Использование "-Unique" с другими параметрами

Пример 6. Выбор уникальных строк с помощью параметра -CaseInsensitive

Пример 7. Выбор новых и старейших событий в журнале событий

Пример 8. Выберите все, кроме первого объекта

Пример 9. Переименование файлов и выбор нескольких для проверки

Пример 10. Отображение сведений о параметре -ExpandProperty

Пример 11. Создание настраиваемых свойств для объектов

Пример 12. Создание вычисляемых свойств для каждого объекта InputObject

Пример 13. Выбор хэш-ключей без использования вычисляемых свойств

Параметры

-CaseInsensitive

-ExcludeProperty

-ExpandProperty

-First

-Index

-InputObject

-Last

-Property

-Skip

-SkipIndex

-SkipLast

-Unique

-Wait

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

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

Примечания

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

Обратная связь

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