Поиск по сайту:

Sort-Object (Microsoft.PowerShell.Utility)

Sort-Object

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

Сортирует объекты по значениям свойств.

Синтаксис

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 | Сортировка-Объект-Свойство WS-Низ 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 для сортировки объектов по Id. Параметр По убыванию сортирует историю команд от самых новых к самым старым.

Пример 5. Использование хеш-таблицы для сортировки свойств по возрастанию и убыванию.

В этом примере для сортировки объектов используются два свойства: Status и DisplayName. Статус сортируется по убыванию, а DisplayName - по возрастанию.

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

Свойство 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 в порядке возрастания.

Статус - это перечисляемое свойство. Остановлено имеет значение 1, а Выполняется имеет значение 4. Для параметра По убыванию установлено значение $True, чтобы Выполненные процессы отображались перед Остановленными процессами. DisplayName устанавливает для параметра Descending значение $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 с блоком сценария для определения каждого временного интервала файлов между 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, если критерии сортировки равны. В этом примере мы сортируем числа от 1 до 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

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

Пример 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.

Пример 11. Сортировка хеш-таблиц по значению ключа

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

@(
    @{ name = 'a' ; weight = 7 }
    @{ name = 'b' ; weight = 1 }
    @{ name = 'c' ; weight = 3 }
    @{ name = 'd' ; weight = 7 }
) | Sort-Object -Property weight -OutVariable Sorted

$Sorted | ForEach-Object -Process { "{0}: {1}" -f $_.name, $_.weight }

Name                           Value
----                           -----
Weight                         1
Name                           b
Weight                         3
Name                           c
Weight                         7
Name                           a
Weight                         7
Name                           d

b: 1
c: 3
a: 7
d: 7

Параметры

-Bottom

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

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-CaseSensitive

Указывает, что сортировка чувствительна к регистру. По умолчанию сортировка не учитывает регистр.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

Регистронезависимый

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Culture

Указывает культурную конфигурацию, используемую для сортировок. Используйте Get-Culture, чтобы отобразить конфигурацию культуры системы.

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Descending

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

Чтобы отсортировать несколько свойств с разным порядком сортировки, используйте хеш-таблицу. Например, с помощью хеш-таблицы вы можете отсортировать одно свойство по возрастанию, а другое — по убыванию.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

восходящий

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-InputObject

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

Тип :

PSОбъект

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Property

Указывает имена свойств, которые Sort-Object использует для сортировки объектов. Подстановочные знаки разрешены. Объекты сортируются на основе значений свойств. Если вы не укажете свойство, Sort-Object выполняет сортировку на основе свойств по умолчанию для типа объекта или самих объектов.

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

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

Действительные ключи для хеш-таблицы следующие:

  • выражение - <string> или <блок сценария>
  • по возрастанию или по убыванию — <boolean>

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

Тип :

Object[]

Позиция:

0

Значение по умолчанию:

Свойства по умолчанию

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

True

-Stable

Отсортированные объекты доставляются в том порядке, в котором они были получены, если критерии сортировки совпадают.

Этот параметр был добавлен в PowerShell v6.2.0.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Top

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

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Unique

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

Уникальный не учитывает регистр. Строки, которые различаются только регистром символов, считаются одинаковыми. Например, характер и ХАРАКТЕР.

Тип :

SwitchParameter

Позиция:

Именованный

Значение по умолчанию:

Все

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

PSObject

Вы можете передать объекты для сортировки в этот командлет.

Выходы

PSObject

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

Примечания

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

  • Windows:

      sort

Командлет 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 параметр Остановлен имеет значение 1, а Работает имеет значение 4. Остановлено сортируется перед Выполняется из-за перечисляемых значений. Дополнительные сведения см. в разделе ServiceControllerStatus.

Производительность алгоритма сортировки снижается при выполнении стабильной сортировки.