Sort-Object

Ссылка

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

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

Синтаксис

Sort-Object
    [[-Property] <Object[]>]
    [-Descending]
    [-Unique]
    [-InputObject <psobject>]
    [-Culture <string>]
    [-CaseSensitive]
    [<CommonParameters>]

Описание

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

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

Примеры

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

Эта команда сортирует файлы и подкаталоги в каталоге.

PS> 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 получает файлы и подкаталоги из каталога, указанного параметром PathC:\Test. Объекты отправляются по конвейеру в Sort-Object командлет . Sort-Object не указывает свойство , поэтому выходные данные сортируются по свойству сортировки по умолчанию Name.

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

Эта команда отображает файлы в текущем каталоге по длине в порядке возрастания.

PS> 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).

PS> 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 .

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

Эта команда сортирует объекты HistoryInfo сеанса PowerShell с помощью свойства Id . Каждый сеанс PowerShell имеет собственный журнал команд.

PS> 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.

PS C:\> 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.

PS> Get-ChildItem -Path C:\Test\*.txt | Sort-Object -Property @{Expression = {$_.CreationTime - $_.LastWriteTime}; Descending = $False} | 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. Параметру По убыванию задано значение $False для сортировки в порядке от самого длинного до кратчайшего интервала времени.

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

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

PS> Get-Content -Path C:\Test\ServerNames.txt
localhost
server01
server25
LOCALHOST
Server19
server3
localhost

PS> Get-Content -Path C:\Test\ServerNames.txt | Sort-Object
localhost
LOCALHOST
localhost
server01
Server19
server25
server3

PS> 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 , что объекты являются строками или целыми числами.

PS> Get-Content -Path C:\Test\ProductId.txt | Sort-Object
0
1
12345
1500
2
2800
3500
4100
500
6200
77
88
99999

PS> Get-Content -Path C:\Test\ProductId.txt | ForEach-Object -Process {[int]$_} | Sort-Object
0
1
2
77
88
500
1500
2800
3500
4100
6200
12345
99999

Командлет Get-Content использует параметр Path для указания каталога и имени файла. Файл ProductId.txt содержит несортированные номера продуктов. Строковые объекты отправляются по конвейеру в ForEach-Object командлет . ForEach-Object использует блок скрипта для преобразования строк в целые числа. В примере кода [int] преобразует строку в целое число и $_ представляет каждую строку по мере ее завершения по конвейеру. Целочисленные объекты отправляются по конвейеру в Sort-Object командлет . Sort-Object сортирует целочисленные объекты в числовом порядке.

Параметры

-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 может быть вычисляемым свойством. Чтобы создать вычисляемое свойство, используйте хэш-таблицу.

Ниже приведены допустимые ключи для хэш-таблицы.

Expression <строка> или <блок скрипта>;
Логическое значение по возрастанию <>
Логическое значение по убыванию <>

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

-Unique

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

Уникальность не учитывает регистр. Строки, отличающиеся только регистром символов, считаются одинаковыми. Например, character и CHARACTER.

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

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

PSObject

Объекты для сортировки можно передать по конвейеру в Sort-Object.

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

PSObject

Sort-Object возвращает отсортированные объекты.

Примечания

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

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

При сортировке по перечислению свойства, например Status, Sort-Object выполняет сортировку по значениям перечисления. Параметр Stopped имеет значение 1 , а running — значение 4. Остановлено отсортировано перед выполнением из-за перечисленных значений. Дополнительные сведения см. в разделе ServiceControllerStatus.

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

Sort-Object

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

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

Параметры

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Unique

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

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

Примечания

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

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

Sort-Object

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

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

Параметры

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Unique

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

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

Примечания

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

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