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 получает файлы и вложенные каталоги из каталога, указанного параметром пути, 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 получает файлы из каталога, указанного параметром пути. Параметр файла указывает, что 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 использует параметр свойства для сортировки объектов по WS. Объекты отправляются по конвейеру в командлет Select-Object. Select-Object использует параметр Last для указания последних пяти объектов, которые являются объектами с самым высоким использования WS.

В PowerShell 6 параметр Sort-ObjectBottom является альтернативой Select-Object. Например, Get-Process | Sort-Object -Property WS -Bottom 5.

Пример 4. Сортировка объектов HistoryInfo по идентификатору

Эта команда сортирует объекты History Info сеанса 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 использует параметр свойства для сортировки объектов по идентификатору . Параметр Убывание сортирует журнал команд от самых новых до старых.

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

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

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

Свойство состояния, используемое в хэш-таблице, является перечисленным свойством. Дополнительные сведения см. в 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 использует параметр свойства с хэш-таблицей, чтобы указать имена свойств и заказы сортировки. Параметр свойства отсортирован по двум свойствам, состояние в порядке убывания и DisplayName в порядке возрастания.

Состояние является перечисленным свойством. Остановленный имеет значение 1 и Выполнение имеет значение 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 использует параметр пути для указания C:\Test каталога и всех файлов *.txt. Объекты отправляются по конвейеру в командлет Sort-Object. Sort-Object использует параметр свойства с блоком скрипта, чтобы определить интервал времени между 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 использует параметр пути для указания каталога и имени файла. Файл ServerNames.txt содержит неортизованный список имен компьютеров.

Командлет Get-Content использует параметр пути для указания каталога и имени файла. Файл ServerNames.txt содержит неортизованный список имен компьютеров. Объекты отправляются по конвейеру в командлет Sort-Object. Sort-Object сортирует список в порядке по умолчанию по возрастанию.

Командлет Get-Content использует параметр пути для указания каталога и имени файла. Файл 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или стабильных, отсортированные объекты доставляются в том порядке, в который они были получены Sort-Object, когда критерии сортировки равны. В этом примере мы отсортируем числа по 20 по их значению modulo 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 получает файлы из каталога, указанного параметром пути. Объекты отправляются по конвейеру в командлет Sort-Object. Sort-Object использует параметр Length и Name для сортировки файлов по длине по возрастанию. Так как File01.txt и File03.txt имеют одинаковую длину, они будут отсортированы по их свойству Name.

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

Начиная с PowerShell 6, Sort-Object поддерживает сортировку хэш-таблицы входных данных по значениям ключей. В следующем примере выполняется сортировка массива хэш-элементов по значению 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
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CaseSensitive

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

Тип:	SwitchParameter
Position:	Named
Default value:	Case-insensitive
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Culture

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Descending

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

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

Тип:	SwitchParameter
Position:	Named
Default value:	Ascending
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

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

Тип:	PSObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Property

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

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

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

Допустимые ключи для хэш-таблицы приведены следующим образом:

expression - <string> или <script block>
ascending или descending - <boolean>

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

Тип:	Object[]
Position:	0
Default value:	Default properties
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-Stable

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

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Top

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

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

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Unique

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

уникальные не учитывает регистр. Строки, которые отличаются только по регистру символов, считаются одинаковыми. Например, символ и СИМВОЛ.

Тип:	SwitchParameter
Position:	Named
Default value:	All
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

PSObject

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

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

PSObject

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

Примечания

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

Виндоус:
- sort

Командлет Sort-Object сортирует объекты на основе свойств, указанных в команде, или свойств сортировки по умолчанию для типа объекта. Свойства сортировки по умолчанию определяются с помощью PropertySet с именем DefaultKeyPropertySet в файле types.ps1xml. Дополнительные сведения см. в разделе about_Types.ps1xml.

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

Если свойства сортировки недоступны, PowerShell пытается сравнить сами объекты. Sort-Object использует метод Compare для каждого свойства. Если свойство не реализует IComparable, командлет преобразует значение свойства в строку и использует метод Compare для System.String. Дополнительные сведения см. в методе PSObject.CompareTo(Object).

Если выполнить сортировку по перечислению, например состояния, Sort-Object сортируется по значениям перечисления. Для служб Windows Остановленный имеет значение 1 и выполнение имеет значение 4. Остановленная отсортирована перед выполнением из-за перечисленных значений. Дополнительные сведения см. в ServiceControllerStatus.

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

Поделиться через

Sort-Object

Синтаксис

Описание

Примеры

Пример 1. Сортировка текущего каталога по имени

Пример 2. Сортировка текущего каталога по длине файла

Пример 3. Сортировка процессов по использованию памяти

Пример 4. Сортировка объектов HistoryInfo по идентификатору

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

Пример 6. Сортировка текстовых файлов по временному интервалу

Пример 7. Сортировка имен в текстовом файле

Пример 8. Сортировка строки в виде целого числа

Пример 9. Использование стабильных сортировок

Пример 10. Сортировка по нескольким свойствам

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

Параметры

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

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

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

Примечания

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

Поделиться через

Sort-Object

Синтаксис

Описание

Примеры

Пример 1. Сортировка текущего каталога по имени

Пример 2. Сортировка текущего каталога по длине файла

Пример 3. Сортировка процессов по использованию памяти

Пример 4. Сортировка объектов HistoryInfo по идентификатору

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

Пример 6. Сортировка текстовых файлов по временному интервалу

Пример 7. Сортировка имен в текстовом файле

Пример 8. Сортировка строки в виде целого числа

Пример 9. Использование стабильных сортировок

Пример 10. Сортировка по нескольким свойствам

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

Параметры

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

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

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

Примечания

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

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