Sort-Object
Sortuje obiekty według wartości właściwości.
Składnia
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>]
Opis
Polecenie Sort-Object
cmdlet sortuje obiekty w kolejności rosnącej lub malejącej na podstawie wartości właściwości obiektu. Jeśli właściwości sortowania nie są uwzględnione w poleceniu, program PowerShell używa domyślnych właściwości sortowania pierwszego obiektu wejściowego. Jeśli typ obiektu wejściowego nie ma domyślnych właściwości sortowania, program PowerShell próbuje porównać same obiekty. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .
Obiekty można sortować według jednej właściwości lub wielu właściwości. Wiele właściwości używa tabel skrótów do sortowania w kolejności rosnącej, kolejności malejącej lub kombinacji zamówień sortowania. Właściwości są sortowane jako rozróżniane wielkość liter lub bez uwzględniania wielkości liter. Użyj unikatowego parametru, aby usunąć duplikaty z danych wyjściowych.
Przykłady
Przykład 1. Sortowanie bieżącego katalogu według nazwy
W tym przykładzie pliki i podkatalogi są sortowane w katalogu.
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
Polecenie Get-ChildItem
cmdlet pobiera pliki i podkatalogi z katalogu określonego przez parametr Path . C:\Test
Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet.
Sort-Object
nie określa właściwości, więc dane wyjściowe są sortowane według domyślnej właściwości sortowania Name.
Przykład 2. Sortowanie bieżącego katalogu według długości pliku
To polecenie wyświetla pliki w bieżącym katalogu według długości w kolejności rosnącej.
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
Polecenie Get-ChildItem
cmdlet pobiera pliki z katalogu określonego przez parametr Path .
Parametr File określa, że Get-ChildItem
pobiera tylko obiekty plików. Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
używa parametru Length do sortowania plików według długości w kolejności rosnącej.
Przykład 3. Sortowanie procesów według użycia pamięci
W tym przykładzie przedstawiono procesy o najwyższym użyciu pamięci na podstawie ich rozmiaru zestawu roboczego (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
Polecenie Get-Process
cmdlet pobiera listę procesów uruchomionych na komputerze. Obiekty procesu są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
używa parametru Property do sortowania obiektów według usług WS. Obiekty są wysyłane w dół potoku Select-Object
do polecenia cmdlet.
Select-Object
Używa ostatniego parametru, aby określić pięć ostatnich obiektów, które są obiektami o najwyższym użyciu usług WS.
W programie PowerShell 6 Sort-Object
parametr Bottom jest alternatywą dla Select-Object
polecenia . Na przykład Get-Process | Sort-Object -Property WS -Bottom 5
.
Przykład 4. Sortowanie obiektów HistoryInfo według identyfikatora
To polecenie sortuje obiekty HistoryInfo sesji programu PowerShell przy użyciu właściwości Id. Każda sesja programu PowerShell ma własną historię poleceń.
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\
Polecenie Get-History
cmdlet pobiera obiekty historii z bieżącej sesji programu PowerShell. Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
używa parametru Property do sortowania obiektów według identyfikatora. Parametr Descending sortuje historię poleceń od najnowszych do najstarszych.
Przykład 5. Używanie tabeli skrótów do sortowania właściwości w kolejności rosnącej i malejącej
W tym przykładzie użyto dwóch właściwości do sortowania obiektów, Status i DisplayName. Stan jest sortowany w kolejności malejącej, a właściwość DisplayName jest sortowana w kolejności rosnącej.
Tabela skrótów służy do określania wartości parametru Właściwości . Tabela skrótów używa wyrażenia do określania nazw właściwości i kolejności sortowania. Aby uzyskać więcej informacji na temat tabel skrótów, zobacz about_Hash_Tables.
Właściwość Status używana w tabeli skrótów jest właściwością wyliczeniową. Aby uzyskać więcej informacji, zobacz 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
Polecenie Get-Service
cmdlet pobiera listę usług na komputerze. Obiekty usługi są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
używa parametru Property z tabelą skrótów, aby określić nazwy właściwości i kolejność sortowania. Parametr Property jest sortowany według dwóch właściwości: Status w kolejności malejącej i DisplayName w kolejności rosnącej.
Status to wyliczona właściwość. Zatrzymana ma wartość 1 , a wartość Running ma wartość 4. Parametr Malejąco jest ustawiony na $True
wartość , aby uruchomione procesy zostały wyświetlone przed zatrzymanych procesów. DisplayName ustawia parametr Descending w celu $False
sortowania nazw wyświetlanych w kolejności alfabetycznej.
Przykład 6. Sortowanie plików tekstowych według przedziału czasu
To polecenie sortuje pliki tekstowe w kolejności malejącej według przedziału czasu między CreationTime i 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
Polecenie Get-ChildItem
cmdlet używa parametru Path , aby określić katalog C:\Test
i wszystkie *.txt
pliki. Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet.
Sort-Object
używa parametru Property z blokiem skryptu, aby określić poszczególne przedziały czasu między parametrem CreationTime i LastWriteTime.
Przykład 7. Sortowanie nazw w pliku tekstowym
W tym przykładzie pokazano, jak sortować listę z pliku tekstowego. Oryginalny plik jest wyświetlany jako lista niesortowana. Sort-Object
sortuje zawartość, a następnie sortuje zawartość za pomocą unikatowego parametru, który usuwa duplikaty.
# 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
Polecenie Get-Content
cmdlet używa parametru Path , aby określić katalog i nazwę pliku. Plik ServerNames.txt
zawiera niesortowaną listę nazw komputerów.
Polecenie Get-Content
cmdlet używa parametru Path , aby określić katalog i nazwę pliku. Plik ServerNames.txt
zawiera niesortowaną listę nazw komputerów. Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
sortuje listę w kolejności domyślnej, rosnąco.
Polecenie Get-Content
cmdlet używa parametru Path , aby określić katalog i nazwę pliku. Plik ServerNames.txt
zawiera niesortowaną listę nazw komputerów. Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
Używa unikatowego parametru w celu usunięcia zduplikowanych nazw komputerów. Lista jest sortowana w kolejności domyślnej rosnąco.
Przykład 8. Sortowanie ciągu jako liczby całkowitej
W tym przykładzie pokazano, jak sortować plik tekstowy zawierający obiekty ciągów jako liczby całkowite. Każde polecenie można wysłać w dół potoku i Get-Member
sprawdzić, czy obiekty są ciągami zamiast liczb całkowitych. W tych przykładach ProductId.txt
plik zawiera niesortowaną listę numerów produktów.
W pierwszym przykładzie Get-Content
pobiera zawartość pliku i potoków wierszy do Sort-Object
polecenia cmdlet . Sort-Object
sortuje obiekty ciągów w kolejności rosnącej.
# 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
W drugim przykładzie Get-Content
pobiera zawartość pliku i potoków wierszy do Sort-Object
polecenia cmdlet. Sort-Object
używa bloku skryptu, aby przekonwertować ciągi na liczby całkowite. W przykładowym kodzie [int]
konwertuje ciąg na liczbę całkowitą i $_
reprezentuje każdy ciąg, ponieważ sprowadza się do potoku. Obiekty całkowite są wysyłane w dół potoku Sort-Object
do polecenia cmdlet .
Sort-Object
sortuje obiekty całkowite w kolejności liczbowej.
Przykład 9. Używanie stabilnych sortowania
W przypadku używania parametrów Góra, Dolna lub Stabilna posortowane obiekty są dostarczane w kolejności, w jakiej zostały odebrane Sort-Object
, gdy kryteria sortowania są równe. W tym przykładzie sortujemy liczby od 20 do 20 według ich wartości "modulo 3". Wartość modulo waha się od zera do dwóch.
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
Dane wyjściowe z pierwszego sortowania są poprawnie pogrupowane według wartości modulu, ale poszczególne elementy nie są sortowane w zakresie modulu. Drugie sortowanie używa opcji Stabilne w celu zwrócenia stabilnego sortowania.
Przykład 10: Sortowanie według wielu właściwości
Jeśli chcesz sortować według wielu właściwości, rozdziel właściwości przecinkami.
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
Polecenie Get-ChildItem
cmdlet pobiera pliki z katalogu określonego przez parametr Path .
Obiekty są wysyłane w dół potoku Sort-Object
do polecenia cmdlet. Sort-Object
używa parametru Length (Długość) i Name (Nazwa) do sortowania plików według długości w kolejności rosnącej. Ponieważ File01.txt
i File03.txt
mają taką samą długość, są one dalej sortowane według nazwy właściwości.
Przykład 11. Sortowanie tabel skrótów według wartości klucza
Począwszy od programu PowerShell 6, Sort-Object
obsługuje sortowanie danych wejściowych w formie skrótu według wartości klucza. Poniższy przykład sortuje tablicę tabel skrótów według wartości klucza każdej tabeli skrótu 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
Parametry
-Bottom
Określa liczbę obiektów do pobrania z końca posortowanej tablicy obiektów. Powoduje to stabilne sortowanie.
Ten parametr został wprowadzony w programie PowerShell 6.0.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-CaseSensitive
Wskazuje, że sortowanie uwzględnia wielkość liter. Domyślnie sortowania nie są uwzględniane wielkości liter.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | Case-insensitive |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Culture
Określa konfigurację kulturową, która ma być używana do sortowania. Służy Get-Culture
do wyświetlania konfiguracji kultury systemu.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Descending
Wskazuje, że Sort-Object
obiekty są sortowane w kolejności malejącej. Wartość domyślna to kolejność rosnąca.
Aby posortować wiele właściwości z różnymi kolejnościami sortowania, użyj tabeli skrótów. Na przykład za pomocą tabeli skrótów można sortować jedną właściwość w kolejności rosnącej i inną właściwość w kolejności malejącej.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | Ascending |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InputObject
Aby posortować obiekty, wyślij je w dół potoku do .Sort-Object
Jeśli używasz parametru InputObject do przesyłania kolekcji elementów, Sort-Object
otrzyma jeden obiekt reprezentujący kolekcję. Ponieważ nie można sortować jednego obiektu, Sort-Object
zwraca całą kolekcję bez zmian.
Typ: | PSObject |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Property
Określa nazwy właściwości używane Sort-Object
do sortowania obiektów. Dozwolone są symbole wieloznaczne.
Obiekty są sortowane na podstawie wartości właściwości. Jeśli nie określisz właściwości, Sort-Object
sortuje je na podstawie właściwości domyślnych dla typu obiektu lub samych obiektów.
Użyj przecinków, aby oddzielić wiele właściwości. Wiele właściwości można sortować w kolejności rosnącej, kolejności malejącej lub kombinacji zamówień sortowania. Po określeniu wielu właściwości obiekty są sortowane według pierwszej właściwości. Jeśli wiele obiektów ma tę samą wartość dla pierwszej właściwości, te obiekty są sortowane według drugiej właściwości. Ten proces jest kontynuowany do momentu, gdy nie ma więcej określonych właściwości ani żadnych grup obiektów.
Wartość parametru Właściwości może być właściwością obliczeniową. Aby utworzyć właściwość obliczeniową, użyj atrybutu scriptblock lub tabeli skrótu.
Prawidłowe klucze dla tabeli skrótów są następujące:
expression
-<string>
lub<script block>
ascending
lubdescending
-<boolean>
Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.
Typ: | Object[] |
Position: | 0 |
Domyślna wartość: | Default properties |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | True |
-Stable
Posortowane obiekty są dostarczane w kolejności, w jakiej zostały odebrane, gdy kryteria sortowania są równe.
Ten parametr został dodany w programie PowerShell w wersji 6.2.0.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Top
Określa liczbę obiektów do pobrania od początku posortowanej tablicy obiektów. Powoduje to stabilne sortowanie.
Ten parametr został wprowadzony w programie PowerShell 6.0.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Unique
Wskazuje, że Sort-Object
eliminuje duplikaty i zwraca tylko unikatowe elementy członkowskie kolekcji. Pierwsze wystąpienie unikatowej wartości jest uwzględniane w posortowanych danych wyjściowych.
Unikatowe jest bez uwzględniania wielkości liter. Ciągi, które różnią się tylko wielkością znaków, są traktowane tak samo. Na przykład znak i znak.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | All |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Obiekty, które mają zostać posortowane, można przekazać potok do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca posortowane obiekty.
Uwagi
Program PowerShell zawiera następujące aliasy dla programu Sort-Object
:
- Windows:
sort
Polecenie Sort-Object
cmdlet sortuje obiekty na podstawie właściwości określonych w poleceniu lub domyślnych właściwości sortowania dla typu obiektu. Domyślne właściwości sortowania PropertySet
są definiowane przy użyciu nazwy DefaultKeyPropertySet
w types.ps1xml
pliku. Aby uzyskać więcej informacji, zobacz about_Types.ps1xml.
Jeśli obiekt nie ma jednej z określonych właściwości, wartość właściwości dla tego obiektu jest interpretowana przez Sort-Object
wartość Null i umieszczona na końcu kolejności sortowania.
Gdy nie są dostępne żadne właściwości sortowania, program PowerShell próbuje porównać same obiekty.
Sort-Object
używa metody Compare dla każdej właściwości. Jeśli właściwość nie implementuje funkcji IComparable, polecenie cmdlet konwertuje wartość właściwości na ciąg i używa metody Compare dla parametru System.String. Aby uzyskać więcej informacji, zobacz METODA PSObject.CompareTo(Object).
Jeśli sortujesz według właściwości wyliczonej, takiej jak Status, Sort-Object
sortuje według wartości wyliczenia. W przypadku usług systemu Windows zatrzymana ma wartość 1, a wartość Uruchomiona ma wartość 4.
Zatrzymano jest sortowane przed uruchomieniem z powodu wyliczonych wartości. Aby uzyskać więcej informacji, zobacz ServiceControllerStatus.
Wydajność algorytmu sortowania jest wolniejsza podczas stabilnego sortowania.