Sort-Object
Seřadí objekty podle hodnot vlastností.
Syntax
Default (Výchozí)
Sort-Object
[[-Property] <Object[]>]
[-Descending]
[-Unique]
[-InputObject <psobject>]
[-Culture <string>]
[-CaseSensitive]
[<CommonParameters>]
Description
Rutina Sort-Object seřadí objekty vzestupně nebo sestupně podle hodnot vlastností objektu. Pokud příkaz neobsahuje vlastnosti řazení, PowerShell použije výchozí vlastnosti řazení.
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. Pomocí parametru Unique můžete z výstupu odstranit duplicity.
Příklady
Příklad 1: Seřazení aktuálního adresáře podle názvu
Tento příkaz seřadí soubory a podadresáře v adresáři.
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
Rutina Get-ChildItem získá soubory a podadresáře z adresáře určeného parametrem Path C :\Test. Objekty se odesílají do Sort-Object rutiny.
Sort-Object neurčuje vlastnost, takže výstup je seřazen podle výchozí vlastnosti třídění, Name.
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í.
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
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).
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
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.
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ů.
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\
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říkaz používá k uspořádání objektů dvě vlastnosti, 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.
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
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.
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
Rutina Get-ChildItem používá parametr Path k určení adresáře C:\Test a všech *.txt souborů. Objekty se odesílají do Sort-Object rutiny.
Sort-Object používá parametr Property s tabulkou hash k určení časového rozpětí každého souboru mezi CreationTime a LastWriteTime. Parametr Sestupně je nastaven na hodnotu $False tak, aby řadil v pořadí od nejdelšího po nejkratší časové rozpětí.
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.
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
Rutina Get-Content používá parametr Path k určení adresáře a názvu souboru. Soubor ServerNames.txt obsahuje neseřazený seznam názvů počítačů.
Rutina Get-Content používá parametr Path k určení adresáře a názvu 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ě.
Rutina Get-Content používá parametr Path k určení adresáře a názvu souboru. Soubor ServerNames.txt obsahuje neseřazený seznam názvů počítačů. Objekty se odesílají do Sort-Object rutiny.
Sort-Object používá parametr Unique k odebrání duplicitních názvů počítačů. Seznam se seřadí 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 můžete odeslat do kanálu a Get-Member ověřit, zda jsou objekty řetězce nebo celá čísla.
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
Rutina Get-Content používá parametr Path k určení adresáře a názvu souboru. Soubor ProductId.txt obsahuje neseřazený seznam čísel produktů. Objekty řetězců jsou odesílány kanálem do rutiny Sort-Object .
Sort-Object seřadí objekty řetězců ve vzestupném pořadí.
Rutina Get-Content používá parametr Path k určení adresáře a názvu souboru. Soubor ProductId.txt obsahuje neseřazený seznam čísel produktů. Objekty řetězců jsou odesílány kanálem do rutiny ForEach-Object .
ForEach-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í.
Parametry
-CaseSensitive
Označuje, že řazení rozlišují malá a velká písmena. Ve výchozím nastavení se při řazení nerozlišují velká a malá 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 nelze 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 neurčíte vlastnost, Sort-Object seřadí se na základě výchozích vlastností pro typ objektu.
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 tabulku hash.
Platné klíče pro tabulku hash jsou následující:
- < bloku skriptu >výrazu< nebo bloku skriptu >
- Vzestupná <booleovská hodnota>
- Sestupná <booleovská hodnota>
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 |
-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é chcete seřadit Sort-Object, můžete propojit.
Výstupy
PSObject
Sort-Object Vrátí seřazené objekty.
Poznámky
Rutina Sort-Object seřadí objekty na základě vlastností zadaných v příkazu nebo výchozích vlastností řazení pro typ objektu. Pokud objekt nemá jednu ze zadaných vlastností, hodnota vlastnosti pro tento objekt je interpretována jako Sort-ObjectNull a umístěna na konec pořadí uspořádání.
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.
Zastaveno má hodnotu 1 a Spuštěný má hodnotu 4.
Zastaveno je seřazeno před Spuštěno kvůli výčtu hodnot. Další informace naleznete v tématu ServiceControllerStatus.