Sort-Object
Сортирует объекты по значениям свойств.
Синтаксис
Sort-Object
[-Stable]
[-Descending]
[-Unique]
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Sort-Object
[-Descending]
[-Unique]
-Top <Int32>
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Sort-Object
[-Descending]
[-Unique]
-Bottom <Int32>
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Описание
Командлет Sort-Object
сортирует объекты по возрастанию или убыванию на основе значений свойств объекта. Если свойства сортировки не включены в команду, PowerShell использует свойства сортировки по умолчанию первого входного объекта. Если тип входного объекта не имеет свойств сортировки по умолчанию, PowerShell пытается сравнить сами объекты. Дополнительные сведения см. в разделе Примечания.
Объекты можно сортировать по одному свойству или нескольким свойствам. Несколько свойств используют хэш-таблицы для сортировки по возрастанию, убыванию или сочетанию порядка сортировки. Свойства сортируются как с учетом регистра или без учета регистра. Используйте параметр Unique , чтобы исключить дубликаты из выходных данных.
Примеры
Пример 1. Сортировка текущего каталога по имени
В этом примере выполняется сортировка файлов и подкаталогов в каталоге.
Get-ChildItem -Path C:\Test | Sort-Object
Directory: C:\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 2/13/2019 08:55 26 anotherfile.txt
-a---- 2/13/2019 13:26 20 Bfile.txt
-a---- 2/12/2019 15:40 118014 Command.txt
-a---- 2/1/2019 08:43 183 CreateTestFile.ps1
d----- 2/25/2019 18:25 Files
d----- 2/25/2019 18:24 Logs
-ar--- 2/12/2019 14:31 27 ReadOnlyFile.txt
-a---- 2/12/2019 16:24 23 Zsystemlog.log
Командлет Get-ChildItem
получает файлы и подкаталоги из каталога, указанного параметром Path , C:\Test
. Объекты отправляются по конвейеру в Sort-Object
командлет .
Sort-Object
не указывает свойство , поэтому выходные данные сортируются по свойству сортировки по умолчанию Name.
Пример 2. Сортировка текущего каталога по длине файла
Эта команда отображает файлы в текущем каталоге по длине в порядке возрастания.
Get-ChildItem -Path C:\Test -File | Sort-Object -Property Length
Directory: C:\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 2/13/2019 13:26 20 Bfile.txt
-a---- 2/12/2019 16:24 23 Zsystemlog.log
-a---- 2/13/2019 08:55 26 anotherfile.txt
-ar--- 2/12/2019 14:31 27 ReadOnlyFile.txt
-a---- 2/1/2019 08:43 183 CreateTestFile.ps1
-a---- 2/12/2019 15:40 118014 Command.txt
Командлет Get-ChildItem
получает файлы из каталога, указанного параметром Path .
Параметр File указывает, что Get-ChildItem
получает только объекты файлов. Объекты отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметр Length для сортировки файлов по длине в порядке возрастания.
Пример 3. Сортировка процессов по использованию памяти
В этом примере показаны процессы с наибольшим использованием памяти в зависимости от размера рабочего набора (WS).
Get-Process | Sort-Object -Property WS | Select-Object -Last 5
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
136 193.92 217.11 889.16 87492 8 OUTLOOK
112 347.73 297.02 95.19 106908 8 Teams
206 266.54 323.71 37.17 60620 8 MicrosoftEdgeCP
35 552.19 549.94 131.66 6552 8 Code
0 1.43 595.12 0.00 2780 0 Memory Compression
Командлет Get-Process
получает список процессов, запущенных на компьютере. Объекты процесса отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметр Property для сортировки объектов по WS. Объекты отправляются по конвейеру в Select-Object
командлет .
Select-Object
использует параметр Last , чтобы указать последние пять объектов, которые являются объектами с наибольшим использованием WS .
В PowerShell 6 Sort-Object
параметр Bottom является альтернативой Select-Object
. Например, Get-Process | Sort-Object -Property WS -Bottom 5
.
Пример 4. Сортировка объектов HistoryInfo по идентификатору
Эта команда сортирует объекты HistoryInfo сеанса PowerShell с помощью свойства Id . Каждый сеанс PowerShell имеет собственный журнал команд.
Get-History | Sort-Object -Property Id -Descending
Id CommandLine
-- -----------
10 Get-Command Sort-Object -Syntax
9 $PSVersionTable
8 Get-Command Sort-Object -Syntax
7 Get-Command Sort-Object -ShowCommandInfo
6 Get-ChildItem -Path C:\Test | Sort-Object -Property Length
5 Get-Help Clear-History -online
4 Get-Help Clear-History -full
3 Get-ChildItem | Get-Member
2 Get-Command Sort-Object -Syntax
1 Set-Location C:\Test\
Командлет Get-History
получает объекты журнала из текущего сеанса PowerShell. Объекты отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметр Property для сортировки объектов по идентификатору. Параметр убывание сортирует журнал команд от самых новых к старым.
Пример 5. Использование хэш-таблицы для сортировки свойств в порядке возрастания и убывания
В этом примере используются два свойства для сортировки объектов: Status и DisplayName. Состояние сортируется по убыванию, а DisplayName — по возрастанию.
Хэш-таблица используется для указания значения параметра Property . Хэш-таблица использует выражение для указания имен свойств и порядка сортировки. Дополнительные сведения о хэш-таблицах см. здесь.
Свойство Status , используемое в хэш-таблице, является перечислимым свойством. Дополнительные сведения см. в разделе ServiceControllerStatus.
Get-Service |
Sort-Object -Property @{Expression = "Status"; Descending = $true},
@{Expression = "DisplayName"; Descending = $false}
Status Name DisplayName
------ ---- -----------
Running Appinfo Application Information
Running BthAvctpSvc AVCTP service
Running BrokerInfrastru... Background Tasks Infrastructure Ser...
Running BDESVC BitLocker Drive Encryption Service
Running CoreMessagingRe... CoreMessaging
Running VaultSvc Credential Manager
Running DsSvc Data Sharing Service
Running Dhcp DHCP Client
...
Stopped ALG Application Layer Gateway Service
Stopped AppMgmt Application Management
Stopped BITS Background Intelligent Transfer Ser...
Stopped wbengine Block Level Backup Engine Service
Stopped BluetoothUserSe... Bluetooth User Support Service_14fb...
Stopped COMSysApp COM+ System Application
Stopped smstsmgr ConfigMgr Task Sequence Agent
Stopped DeviceInstall Device Install Service
Stopped MSDTC Distributed Transaction Coordinator
Командлет Get-Service
получает список служб на компьютере. Объекты службы отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметр Property с хэш-таблицей для указания имен свойств и порядка сортировки. Параметр Property сортируется по двум свойствам: Status в порядке убывания и DisplayName в порядке возрастания.
Status — это перечисляемое свойство. Параметр Stopped имеет значение 1 , а Значение Running — 4. Параметру Убывание присвоено значение $True
, чтобы выполняющиеся процессы отображались перед остановленными процессами. DisplayName задает параметру Убывание значение $False
, чтобы отсортировать отображаемые имена в алфавитном порядке.
Пример 6. Сортировка текстовых файлов по интервалу времени
Эта команда сортирует текстовые файлы в порядке убывания по интервалу времени между CreationTime и LastWriteTime.
Get-ChildItem -Path C:\Test\*.txt |
Sort-Object -Property {$_.CreationTime - $_.LastWriteTime} |
Format-Table CreationTime, LastWriteTime, FullName
CreationTime LastWriteTime FullName
------------ ------------- --------
11/21/2018 12:39:01 2/26/2019 08:59:36 C:\Test\test2.txt
12/4/2018 08:29:41 2/26/2019 08:57:05 C:\Test\powershell_list.txt
2/20/2019 08:15:59 2/26/2019 12:09:43 C:\Test\CreateTestFile.txt
2/20/2019 08:15:59 2/26/2019 12:07:41 C:\Test\Command.txt
2/20/2019 08:15:59 2/26/2019 08:57:52 C:\Test\ReadOnlyFile.txt
11/29/2018 15:16:50 12/4/2018 16:16:24 C:\Test\LogData.txt
2/25/2019 18:25:11 2/26/2019 12:08:47 C:\Test\Zsystemlog.txt
2/25/2019 18:25:11 2/26/2019 08:55:33 C:\Test\Bfile.txt
2/26/2019 08:46:59 2/26/2019 12:12:19 C:\Test\LogFile3.txt
Командлет Get-ChildItem
использует параметр Path для указания каталога C:\Test
и всех *.txt
файлов. Объекты отправляются по конвейеру в Sort-Object
командлет .
Sort-Object
использует параметр Property с блоком scriptblock для определения интервала времени между CreationTime и LastWriteTime.
Пример 7. Сортировка имен в текстовом файле
В этом примере показано, как отсортировать список из текстового файла. Исходный файл отображается в виде несортированного списка. Sort-Object
сортирует содержимое, а затем сортирует его с помощью параметра Unique , который удаляет дубликаты.
# All items unsorted
Get-Content -Path C:\Test\ServerNames.txt
localhost
server01
server25
LOCALHOST
Server19
server3
localhost
# All items sorted
Get-Content -Path C:\Test\ServerNames.txt | Sort-Object
localhost
LOCALHOST
localhost
server01
Server19
server25
server3
# Unique filtered items sorted
Get-Content -Path C:\Test\ServerNames.txt | Sort-Object -Unique
localhost
server01
Server19
server25
server3
Командлет Get-Content
использует параметр Path для указания каталога и имени файла. Файл ServerNames.txt
содержит несортированные имена компьютеров.
Командлет Get-Content
использует параметр Path для указания каталога и имени файла. Файл ServerNames.txt
содержит несортированные имена компьютеров. Объекты отправляются по конвейеру в Sort-Object
командлет . Sort-Object
сортирует список в порядке по умолчанию по возрастанию.
Командлет Get-Content
использует параметр Path для указания каталога и имени файла. Файл ServerNames.txt
содержит несортированные имена компьютеров. Объекты отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметр Unique для удаления повторяющихся имен компьютеров. Список отсортирован по умолчанию по возрастанию.
Пример 8. Сортировка строки как целого числа
В этом примере показано, как отсортировать текстовый файл, содержащий строковые объекты в виде целых чисел. Вы можете отправить каждую команду в конвейер Get-Member
и убедиться, что объекты являются строками, а не целыми числами. В этих примерах ProductId.txt
файл содержит несортированные номера продуктов.
В первом примере Get-Content
получает содержимое файла и передает строки командлету Sort-Object
. Sort-Object
сортирует строковые объекты в порядке возрастания.
# String sorted
Get-Content -Path C:\Test\ProductId.txt | Sort-Object
0
1
12345
1500
2
2800
3500
4100
500
6200
77
88
99999
# Integer sorted
Get-Content -Path C:\Test\ProductId.txt | Sort-Object {[int]$_}
0
1
2
77
88
500
1500
2800
3500
4100
6200
12345
99999
Во втором примере Get-Content
получает содержимое файла и передает строки командлету Sort-Object
. Sort-Object
использует блок скрипта для преобразования строк в целые числа. В примере кода [int]
преобразует строку в целое число и $_
представляет каждую строку по мере ее завершения по конвейеру. Целочисленные объекты отправляются по конвейеру в Sort-Object
командлет .
Sort-Object
сортирует целочисленные объекты в числовом порядке.
Пример 9. Использование стабильных сортировок
При использовании параметров Top, Bottom или Stable отсортированные объекты доставляются в том порядке, в каком Sort-Object
они были получены, когда критерии сортировки равны. В этом примере мы отсортируем числа с одного по 20 по их значению "по модулю 3". Значение по модулю в диапазоне от нуля до двух.
1..20 |Sort-Object {$_ % 3}
18
3
15
6
12
9
1
16
13
10
7
4
19
11
8
14
5
17
2
20
1..20 |Sort-Object {$_ % 3} -Stable
3
6
9
12
15
18
1
4
7
10
13
16
19
2
5
8
11
14
17
20
Выходные данные первой сортировки правильно группируются по значению модуля, но отдельные элементы не сортируются в диапазоне модулей. Вторая сортировка использует параметр Stable для возврата стабильной сортировки.
Пример 10. Сортировка по нескольким свойствам
Если вы хотите выполнить сортировку по нескольким свойствам, разделите свойства запятыми.
Get-ChildItem -Path C:\Test | Sort-Object Length,Name
Directory: C:\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 13/10/2021 22:16 2 File01.txt
-a--- 13/10/2021 22:16 2 File03.txt
-a--- 13/10/2021 22:18 64 File02.txt
-a--- 13/10/2021 22:18 64 File04.txt
Командлет Get-ChildItem
получает файлы из каталога, указанного параметром Path . Объекты отправляются по конвейеру в Sort-Object
командлет . Sort-Object
использует параметры Length и Name для сортировки файлов по длине в порядке возрастания. Так как File01.txt
и File03.txt
имеют одинаковую длину, они далее сортируются по свойству Name.
Параметры
-Bottom
Указывает количество объектов, которые необходимо получить из конца отсортированного массива объектов. Это приводит к стабильной сортировке.
Этот параметр появился в PowerShell 6.0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CaseSensitive
Указывает, что сортировка учитывает регистр. По умолчанию при сортировке регистр не учитывается.
Type: | SwitchParameter |
Position: | Named |
Default value: | Case-insensitive |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Culture
Указывает культурную конфигурацию, используемую для сортировки. Используйте для Get-Culture
отображения конфигурации языка и региональных параметров системы.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Descending
Указывает, что Sort-Object
сортирует объекты в порядке убывания. По умолчанию результаты сортируются по возрастанию.
Чтобы отсортировать несколько свойств с разными порядками сортировки, используйте хэш-таблицу. Например, с помощью хэш-таблицы можно сортировать одно свойство в порядке возрастания, а другое — в порядке убывания.
Type: | SwitchParameter |
Position: | Named |
Default value: | Ascending |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Чтобы отсортировать объекты, отправьте их по конвейеру в Sort-Object
. Если вы используете параметр InputObject для отправки коллекции элементов, получает один объект, Sort-Object
представляющий коллекцию. Так как один объект не может быть отсортирован, Sort-Object
возвращает всю коллекцию без изменений.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Property
Задает имена свойств, которые Sort-Object
используются для сортировки объектов. Разрешено использовать подстановочные знаки.
Объекты сортируются на основе значений свойств. Если свойство не указано, Sort-Object
выполняет сортировку по свойствам по умолчанию для типа объекта или самих объектов.
Используйте запятые для разделения нескольких свойств. Несколько свойств можно сортировать по возрастанию, по убыванию или по сочетанию порядка сортировки. При указании нескольких свойств объекты сортируются по первому свойству. Если несколько объектов имеют одинаковое значение для первого свойства, эти объекты сортируются по второму свойству. Это продолжается до тех пор, пока не закончатся все указанные свойства или группы объектов.
Значение параметра Property может быть вычисляемым свойством. Чтобы создать вычисляемое свойство, используйте scriptblock или хэш-строку.
Ниже приведены допустимые ключи для хэш-таблицы.
expression
-<string>
или<script block>
ascending
Илиdescending
-<boolean>
Дополнительные сведения см. в разделе about_Calculated_Properties.
Type: | Object[] |
Position: | 0 |
Default value: | Default properties |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Stable
Отсортированные объекты доставляются в том порядке, в каком они были получены, если критерии сортировки равны.
Этот параметр был добавлен в PowerShell версии 6.2.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Top
Указывает количество объектов, которые необходимо получить с начала отсортированного массива объектов. Это приводит к стабильной сортировке.
Этот параметр появился в PowerShell 6.0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Unique
Указывает, что Sort-Object
удаляет дубликаты и возвращает только уникальные члены коллекции. Первый экземпляр уникального значения включается в отсортированные выходные данные.
Уникальность не учитывает регистр. Строки, отличающиеся только регистром символов, считаются одинаковыми. Например, character и CHARACTER.
Type: | SwitchParameter |
Position: | Named |
Default value: | All |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Объекты для сортировки можно передать по конвейеру в Sort-Object
.
Выходные данные
Sort-Object
возвращает отсортированные объекты.
Примечания
Командлет Sort-Object
сортирует объекты на основе свойств, указанных в команде, или свойств сортировки по умолчанию для типа объекта. Свойства сортировки по умолчанию определяются с помощью PropertySet
имени DefaultKeyPropertySet
в types.ps1xml
файле . Дополнительные сведения см. в разделе about_Types.ps1xml.
Если объект не имеет одного из указанных свойств, значение свойства для этого объекта интерпретируется как Sort-Object
Null и помещается в конце порядка сортировки.
Если свойства сортировки недоступны, PowerShell пытается сравнить сами объекты.
Sort-Object
использует метод Compare для каждого свойства. Если свойство не реализует IComparable, командлет преобразует значение свойства в строку и использует метод Compare для System.String. Дополнительные сведения см. в разделе Метод PSObject.CompareTo(Object).
При сортировке по перечислению свойства, например Status, Sort-Object
выполняет сортировку по значениям перечисления. Для служб Windows параметр Stopped имеет значение 1 , а running — значение 4.
Остановлено отсортировано перед выполнением из-за перечисленных значений. Дополнительные сведения см. в разделе ServiceControllerStatus.
Производительность алгоритма сортировки снижается при выполнении стабильной сортировки.