Sort-Object

Odwołanie

Moduł:: Microsoft.PowerShell.Utility

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 wyeliminować 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 Plik 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. 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 wyliczone właściwości. Zatrzymano ma wartość 1 , a wartość Running ma wartość 4. Parametr Descending jest ustawiony na $True wartość , aby uruchomione procesy zostały wyświetlone przed zatrzymaniem procesów. DisplayName ustawia parametr Descending na sortowanie $False 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 do określenia katalogu C:\Test i wszystkich *.txt plików. Obiekty są wysyłane w dół potoku Sort-Object do polecenia cmdlet. Sort-Object używa parametru Property z blokiem skryptu, aby określić przedział czasu poszczególnych plików między CreationTime i LastWriteTime.

Przykład 7. Sortowanie nazw w pliku tekstowym

W tym przykładzie pokazano, jak posortować 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 do określenia katalogu i nazwy pliku. Plik ServerNames.txt zawiera niesortowaną listę nazw komputerów.

Polecenie Get-Content cmdlet używa parametru Path do określenia katalogu i nazwy 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.

Przykład 8. Sortowanie ciągu jako liczby całkowitej

W tym przykładzie pokazano, jak posortować plik tekstowy zawierający obiekty ciągów jako liczby całkowite. Możesz wysłać każde polecenie w dół potoku do Get-Member i 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 do konwertowania ciągów 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 jeden 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 modulo, ale poszczególne elementy nie są sortowane w zakresie modul. Drugie sortowanie używa opcji Stabilne , aby zwrócić stabilne sortowanie.

Przykład 10: Sortowanie według wielu właściwości

Jeśli chcesz sortować według wielu właściwości, oddziel 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.

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.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CaseSensitive

Wskazuje, że sortowanie ma wielkość liter. Domyślnie sortowania nie są uwzględniane wielkości liter.

Type:	SwitchParameter
Position:	Named
Default value:	Case-insensitive
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Descending

Wskazuje, że Sort-Object sortuje obiekty 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.

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

-InputObject

Aby sortować obiekty, wyślij je w dół potoku do Sort-Object. Jeśli używasz parametru InputObject do przesyłania kolekcji elementów, Sort-Object otrzymuje jeden obiekt reprezentujący kolekcję. Ponieważ nie można sortować jednego obiektu, Sort-Object zwraca całą kolekcję bez zmian.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 się na podstawie domyślnych właściwości 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, dopóki nie ma więcej określonych właściwości ani nie ma ż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 elementu scriptblock lub tabeli skrótu.

Prawidłowe klucze dla tabeli skrótów są następujące:

expression - <string> Lub <script block>
ascending Lub descending - <boolean>

Aby uzyskać więcej informacji, zobacz about_Calculated_Properties.

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

-Stable

Posortowane obiekty są dostarczane w kolejności, w której zostały odebrane, gdy kryteria sortowania są równe.

Ten parametr został dodany w programie PowerShell w wersji 6.2.0.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 jako takie same. Na przykład znak i znak.

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

Dane wejściowe

PSObject

Można przekazać do potoku obiekty, które mają zostać posortowane na Sort-Object.

Dane wyjściowe

PSObject

Sort-Object zwraca posortowane obiekty.

Uwagi

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 PropertySettypes.ps1xml są definiowane przy użyciu nazwy DefaultKeyPropertySet w 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 jako Sort-Objectnull i umieszczona na końcu kolejności sortowania.

Gdy nie są dostępne 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 elementu 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).

W przypadku sortowania według wyliczonej właściwości, 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 wykonywania stabilnego sortowania.

Udostępnij za pośrednictwem

Sort-Object

Składnia

Opis

Przykłady

Przykład 1. Sortowanie bieżącego katalogu według nazwy

Przykład 2. Sortowanie bieżącego katalogu według długości pliku

Przykład 3. Sortowanie procesów według użycia pamięci

Przykład 4. Sortowanie obiektów HistoryInfo według identyfikatora

Przykład 5. Używanie tabeli skrótów do sortowania właściwości w kolejności rosnącej i malejącej

Przykład 6. Sortowanie plików tekstowych według przedziału czasu

Przykład 7. Sortowanie nazw w pliku tekstowym

Przykład 8. Sortowanie ciągu jako liczby całkowitej

Przykład 9: Używanie stabilnych sortowania

Przykład 10: Sortowanie według wielu właściwości

Parametry

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Sort-Object

Składnia

Opis

Przykłady

Przykład 1. Sortowanie bieżącego katalogu według nazwy

Przykład 2. Sortowanie bieżącego katalogu według długości pliku

Przykład 3. Sortowanie procesów według użycia pamięci

Przykład 4. Sortowanie obiektów HistoryInfo według identyfikatora

Przykład 5. Używanie tabeli skrótów do sortowania właściwości w kolejności rosnącej i malejącej

Przykład 6. Sortowanie plików tekstowych według przedziału czasu

Przykład 7. Sortowanie nazw w pliku tekstowym

Przykład 8. Sortowanie ciągu jako liczby całkowitej

Przykład 9: Używanie stabilnych sortowania

Przykład 10: Sortowanie według wielu właściwości

Parametry

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby