Sort-Object

Modul:: Microsoft.PowerShell.Utility Module

Seřadí objekty podle hodnot vlastností.

Syntaxe

Default (Výchozí)

Sort-Object
    [[-Property] <Object[]>]
    [-Stable]
    [-Descending]
    [-Unique]
    [-InputObject <PSObject>]
    [-Culture <String>]
    [-CaseSensitive]
    [<CommonParameters>]

Top

Sort-Object
    [[-Property] <Object[]>]
    -Top <Int32>
    [-Descending]
    [-Unique]
    [-InputObject <PSObject>]
    [-Culture <String>]
    [-CaseSensitive]
    [<CommonParameters>]

Bottom

Sort-Object
    [[-Property] <Object[]>]
    -Bottom <Int32>
    [-Descending]
    [-Unique]
    [-InputObject <PSObject>]
    [-Culture <String>]
    [-CaseSensitive]
    [<CommonParameters>]

Description

Rutina Sort-Object seřadí objekty vzestupně nebo sestupně podle hodnot vlastností objektu. Pokud nejsou vlastnosti řazení zahrnuty do příkazu, PowerShell používá výchozí vlastnosti řazení prvního vstupního objektu. Pokud typ vstupního objektu nemá žádné výchozí vlastnosti řazení, PowerShell se pokusí porovnat samotné objekty. Další informace najdete v části Poznámky.

Objekty můžete řadit podle jedné vlastnosti nebo více vlastností. Více vlastností používá tabulky hash k řazení ve vzestupném pořadí, sestupném pořadí nebo kombinaci pořadí řazení. Vlastnosti se seřadí jako malá a velká písmena nebo nerozlišují malá a velká písmena. K odebrání duplicit z výstupu použijte parametr Unique.

Příklady

Příklad 1: Seřazení aktuálního adresáře podle názvu

Tento příklad seřadí soubory a podadresáře v adresáři.

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

Rutina Get-ChildItem získá soubory a podadresáře z adresáře určeného parametrem PathC:\Test. Objekty se odesílají do Sort-Object rutiny. Sort-Object nezadá vlastnost, takže se výstup seřadí podle výchozí vlastnosti řazení, Název.

Příklad 2: Seřazení aktuálního adresáře podle délky souboru

Tento příkaz zobrazí soubory v aktuálním adresáři podle délky ve vzestupném pořadí.

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

Rutina Get-ChildItem získá soubory z adresáře určeného parametrem Path. Parametr File určuje, že Get-ChildItem získá pouze objekty souboru. Objekty se odesílají do Sort-Object rutiny. Sort-Object pomocí parametru Length seřadí soubory podle délky ve vzestupném pořadí.

Příklad 3: Řazení procesů podle využití paměti

Tento příklad zobrazuje procesy s nejvyšším využitím paměti na základě jejich pracovní sady (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

Rutina Get-Process získá seznam procesů spuštěných v počítači. Objekty procesu se odesílají do kanálu do rutiny Sort-Object. Sort-Object používá parametr Vlastnost k řazení objektů podle WS. Objekty se odesílají do Select-Object rutiny. Select-Object pomocí parametru Last určuje posledních pět objektů, což jsou objekty s nejvyšším využitím WS.

V PowerShellu 6 je Sort-Object parametr bottom alternativou k Select-Object. Například: Get-Process | Sort-Object -Property WS -Bottom 5.

Příklad 4: Sort HistoryInfo objekty podle ID

Tento příkaz seřadí objekty HistoryInfo relace PowerShellu pomocí vlastnosti ID. Každá relace PowerShellu má vlastní historii příkazů.

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\

Rutina Get-History získá objekty historie z aktuální relace PowerShellu. Objekty se odesílají do Sort-Object rutiny. Sort-Object pomocí parametru vlastnost seřadí objekty podle id . Parametr Descending seřadí historii příkazů od nejnovějšího po nejstarší.

Příklad 5: Použití hashovací tabulky k řazení vlastností ve vzestupném a sestupném pořadí

Tento příklad používá dvě vlastnosti k řazení objektů, Status a DisplayName. Stav seřadí sestupně a DisplayName seřadí vzestupně.

K určení hodnoty Vlastnosti parametru se používá tabulka hash. Tabulka hash používá výraz k určení názvů vlastností a pořadí řazení. Další informace o tabulkách hash najdete v tématu about_Hash_Tables.

Vlastnost Status použitá v tabulce hash je výčtová vlastnost. Další informace naleznete v tématu 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

Rutina Get-Service získá seznam služeb v počítači. Objekty služby se odesílají do kanálu do rutiny Sort-Object. Sort-Object používá parametr Vlastnost s tabulkou hash k určení názvů vlastností a pořadí řazení. Parametr vlastnosti je seřazený podle dvou vlastností, Stav sestupně a DisplayName ve vzestupném pořadí.

Status je ubytování s výčtem. Zastaveno má hodnotu 1 a Spuštěný má hodnotu 4. Parametr Descending je nastavený na $true, aby se procesy Spuštěné zobrazovaly před procesy Zastaveno. DisplayName nastaví parametr Descending tak, aby $false seřadil zobrazované názvy v abecedním pořadí.

Příklad 6: Řazení textových souborů podle časového rozsahu

Tento příkaz seřadí textové soubory sestupně podle časového rozsahu mezi CreationTime a 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

Rutina Get-ChildItem používá parametr Path k určení C:\Test adresáře a všech *.txt souborů. Objekty se odesílají do Sort-Object rutiny. Sort-Object používá parametr vlastnosti s blokem skriptu k určení každého časového rozsahu souborů mezi CreationTime a LastWriteTime.

Příklad 7: Řazení názvů v textovém souboru

Tento příklad ukazuje, jak seřadit seznam z textového souboru. Původní soubor se zobrazí jako neseřazený seznam. Sort-Object seřadí obsah a potom obsah seřadí pomocí parametru Unique, který odebere duplicity.

# 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

Rutina Get-Content pomocí parametru Path určuje adresář a název souboru. Soubor ServerNames.txt obsahuje neseřazený seznam názvů počítačů.

Rutina Get-Content pomocí parametru Path určuje adresář a název souboru. Soubor ServerNames.txt obsahuje neseřazený seznam názvů počítačů. Objekty se odesílají do Sort-Object rutiny. Sort-Object seřadí seznam ve výchozím pořadí vzestupně.

Příklad 8: Seřazení řetězce jako celého čísla

Tento příklad ukazuje, jak seřadit textový soubor, který obsahuje řetězcové objekty jako celá čísla. Každý příkaz v kanálu můžete odeslat, abyste Get-Member a ověřili, že objekty jsou řetězce místo celých čísel. V těchto příkladech soubor ProductId.txt obsahuje neseřazený seznam čísel produktů.

V prvním příkladu Get-Content získá obsah souboru a čáry řádků do rutiny Sort-Object. Sort-Object seřadí objekty řetězců ve vzestupném pořadí.

# String sorted
Get-Content -Path C:\Test\ProductId.txt | Sort-Object

# Integer sorted
Get-Content -Path C:\Test\ProductId.txt | Sort-Object {[int]$_}

V druhém příkladu Get-Content získá obsah souboru a čáry řádků do rutiny Sort-Object. Sort-Object používá blok skriptu k převodu řetězců na celá čísla. V ukázkovém kódu [int] převede řetězec na celé číslo a $_ představuje každý řetězec v případě, že dojde ke snížení kanálu. Celočíselné objekty se odesílají do kanálu do rutiny Sort-Object. Sort-Object seřadí celočíselné objekty v číselném pořadí.

Příklad 9: Použití stabilních řazení

Když použijete parametry Top, Bottomnebo Stable, budou seřazené objekty doručeny v pořadí, v jakém byly přijaty Sort-Object, když jsou kritéria řazení rovna. V tomto příkladu seřadíme čísla 1 až 20 podle jejich hodnoty modulo 3. Hodnota modulu se pohybuje od nuly do dvou.

1..20 |Sort-Object {$_ % 3}

1..20 |Sort-Object {$_ % 3} -Stable

Výstup prvního řazení je správně seskupený podle hodnoty modulu, ale jednotlivé položky nejsou seřazené v rozsahu modulů. Druhé řazení používá možnost Stabilní k vrácení stabilního řazení.

Příklad 10: Řazení podle více vlastností

Pokud chcete řadit podle více vlastností, oddělte je čárkami.

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

Rutina Get-ChildItem získá soubory z adresáře určeného parametrem Path. Objekty se odesílají do Sort-Object rutiny. Sort-Object pomocí parametru Length a Name seřadí soubory podle délky ve vzestupném pořadí. Vzhledem k tomu, že File01.txt a File03.txt mají stejnou délku, jsou dále seřazené podle vlastnosti Name.

Příklad 11: Seřazení hashovatelných tabulek podle hodnoty klíče

Počínaje PowerShellem 6 Sort-Object podporuje řazení hashtable zadávání podle hodnot klíčů. Následující příklad seřadí pole hashtable podle hodnoty klíče weight každé hashtable.

@(
    @{ 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

Určuje počet objektů, které se mají získat od konce seřazeného pole objektů. Výsledkem je stabilní řazení.

Tento parametr byl představen v PowerShellu 6.0.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Bottom

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-CaseSensitive

Označuje, že řazení rozlišují malá a velká písmena. Řazení ve výchozím nastavení nerozlišují malá a velká písmena.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	Case-insensitive
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Culture

Určuje kulturní konfiguraci, která se má použít pro řazení. Pomocí Get-Culture zobrazte konfiguraci jazykové verze systému.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Descending

Označuje, že Sort-Object seřadí objekty sestupně. Výchozí hodnota je vzestupné pořadí.

Pokud chcete seřadit více vlastností s různými pořadími řazení, použijte tabulku hash. Například s tabulkou hash můžete řadit jednu vlastnost vzestupně a jinou vlastnost sestupně.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	Ascending
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Chcete-li seřadit objekty, odešlete je dolů do kanálu Sort-Object. Pokud použijete parametr InputObject k odeslání kolekce položek, Sort-Object obdrží jeden objekt, který představuje kolekci. Protože jeden objekt nejde seřadit, Sort-Object vrátí celou kolekci beze změny.

Vlastnosti parametru

Typ:	PSObject
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Property

Určuje názvy vlastností, které Sort-Object používá k řazení objektů. Jsou povoleny zástupné symboly. Objekty jsou seřazené na základě hodnot vlastností. Pokud nezadáte vlastnost, Sort-Object seřadí na základě výchozích vlastností pro typ objektu nebo samotné objekty.

K oddělení více vlastností použijte čárky. Více vlastností lze řadit vzestupně, sestupně nebo kombinací pořadí řazení. Když zadáte více vlastností, objekty se seřadí podle první vlastnosti. Pokud má více objektů stejnou hodnotu pro první vlastnost, tyto objekty jsou seřazeny podle druhé vlastnosti. Tento proces pokračuje, dokud nebudou zadány žádné další vlastnosti nebo žádné skupiny objektů.

Hodnota Vlastnosti parametru může být počítaná vlastnost. K vytvoření počítané vlastnosti použijte skriptblock nebo hashtable.

Platné klíče pro tabulku hash jsou následující:

Expression - <string> nebo <script block>
Ascending nebo Descending - <boolean>

Další informace naleznete v dokumentaci about_Calculated_Properties.

Vlastnosti parametru

Typ:	Object[]
Default value:	Default properties
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Stable

Seřazené objekty se doručují v pořadí, v jakém byly přijaty, když jsou kritéria řazení stejná.

Tento parametr byl přidán v PowerShellu v6.2.0.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Default

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Top

Určuje počet objektů, které se mají získat od začátku seřazeného pole objektů. Výsledkem je stabilní řazení.

Tento parametr byl představen v PowerShellu 6.0.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Top

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Unique

Označuje, že Sort-Object eliminuje duplicity a vrací pouze jedinečné členy kolekce. První instance jedinečné hodnoty je zahrnuta do seřazeného výstupu.

jedinečné nerozlišují malá a velká písmena. Řetězce, které se liší pouze písmeny znaků, jsou považovány za stejné. Například znak a ZNAK.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	All
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSObject

Objekty, které se mají řadit, můžete řadit do této rutiny.

Výstupy

PSObject

Tato rutina vrátí seřazené objekty.

Poznámky

PowerShell obsahuje následující aliasy pro Sort-Object:

Windows:
- sort

Rutina Sort-Object seřadí objekty na základě vlastností zadaných v příkazu nebo výchozích vlastností řazení pro typ objektu. Výchozí vlastnosti řazení se definují pomocí PropertySet pojmenované DefaultKeyPropertySet v souboru types.ps1xml. Další informace naleznete v části about_Types.ps1xml.

Pokud objekt nemá jednu ze zadaných vlastností, hodnota vlastnosti pro tento objekt je interpretována Sort-Object jako Null a umístěna na konci pořadí řazení.

Pokud nejsou k dispozici žádné vlastnosti řazení, PowerShell se pokusí porovnat samotné objekty. Sort-Object pro každou vlastnost používá metodu Compare. Pokud vlastnost neimplementuje IComparable, rutina převede hodnotu vlastnosti na řetězec a použije metodu Compare pro System.String. Další informace naleznete v PSObject.CompareTo(Object) Metoda.

Pokud řadíte podle výčtové vlastnosti, například Status, Sort-Object seřadí podle hodnot výčtu. U služeb systému Windows má Zastaveno hodnotu 1 a Spuštěno má hodnotu 4. Zastaveno je seřazeno před Spuštěno kvůli výčtu hodnot. Další informace naleznete v tématu ServiceControllerStatus.

Výkon algoritmu řazení je pomalejší při stabilním řazení.

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

Sort-Object

Syntaxe

Default (Výchozí)

Top

Bottom

Description

Příklady

Příklad 1: Seřazení aktuálního adresáře podle názvu

Příklad 2: Seřazení aktuálního adresáře podle délky souboru

Příklad 3: Řazení procesů podle využití paměti

Příklad 4: Sort HistoryInfo objekty podle ID

Příklad 5: Použití hashovací tabulky k řazení vlastností ve vzestupném a sestupném pořadí

Příklad 6: Řazení textových souborů podle časového rozsahu

Příklad 7: Řazení názvů v textovém souboru

Příklad 8: Seřazení řetězce jako celého čísla

Příklad 9: Použití stabilních řazení

Příklad 10: Řazení podle více vlastností

Příklad 11: Seřazení hashovatelných tabulek podle hodnoty klíče

Parametry

-Bottom

Vlastnosti parametru

Sady parametrů

-CaseSensitive

Vlastnosti parametru

Sady parametrů

-Culture

Vlastnosti parametru

Sady parametrů

-Descending

Vlastnosti parametru

Sady parametrů

-InputObject

Vlastnosti parametru

Sady parametrů

-Property

Vlastnosti parametru

Sady parametrů

-Stable

Vlastnosti parametru

Sady parametrů

-Top

Vlastnosti parametru

Sady parametrů

-Unique

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

PSObject

Výstupy

PSObject

Poznámky

Související odkazy

Váš názor