Sort-Object
プロパティ値別にオブジェクトを並べ替えます。
構文
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>]
説明
コマンドレットは Sort-Object
、オブジェクト プロパティの値に基づいて、オブジェクトを昇順または降順で並べ替えます。 並べ替えプロパティがコマンドに含まれていない場合、PowerShell は最初の入力オブジェクトの既定の並べ替えプロパティを使用します。 入力オブジェクトの型に既定の並べ替えプロパティがない場合、PowerShell はオブジェクト自体の比較を試みます。 詳細については、「メモ」セクションを参照してください。
オブジェクトは、1 つのプロパティまたは複数のプロパティで並べ替えることができます。 複数のプロパティは、ハッシュ テーブルを使用して、昇順、降順、または並べ替え順序の組み合わせで並べ替えます。 プロパティは、大文字と小文字を区別するか、大文字と小文字を区別せずに並べ替えられます。 出力から重複を排除するには、 Unique パラメーターを使用します。
例
例 1: 現在のディレクトリを名前で並べ替える
次の使用例は、ディレクトリ内のファイルとサブディレクトリを並べ替えます。
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
、C:\Test
Path パラメーター で指定されたディレクトリからファイルとサブディレクトリを取得します。 オブジェクトは、パイプラインから コマンドレットに Sort-Object
送信されます。
Sort-Object
では プロパティが指定されないため、出力は既定の並べ替えプロパティ Name で並べ替えられます。
例 2: 現在のディレクトリをファイル長で並べ替える
このコマンドは、現在のディレクトリ内のファイルを昇順で長さで表示します。
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) サイズに基づいて、メモリ使用量が最も多いプロセスを表示します。
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 使用率が最も高いオブジェクトである最後の 5 つのオブジェクトを指定します。
PowerShell 6 では、 Sort-Object
パラメーター Bottom は に代わるもの Select-Object
になります。 たとえば、「 Get-Process | Sort-Object -Property WS -Bottom 5
」のように入力します。
例 4: Id で HistoryInfo オブジェクトを並べ替える
このコマンドは、Id プロパティを使用して、PowerShell セッションの HistoryInfo オブジェクトを並べ替えます。 各 PowerShell セッションには、独自のコマンド履歴があります。
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 パラメーターを使用して、オブジェクトを ID で並べ替えます。Descending パラメーターは、コマンド履歴を最新から最も古いものに並べ替えます。
例 5: ハッシュ テーブルを使用してプロパティを昇順および降順に並べ替える
この例では、 Status と DisplayName の 2 つのプロパティを使用してオブジェクトを並べ替えます。 Status は降順で並べ替え、 DisplayName は昇順で並べ替えられます。
ハッシュ テーブルは、 Property パラメーターの値を指定するために使用されます。 ハッシュ テーブルでは、式を使用してプロパティ名と並べ替え順序を指定します。 ハッシュ テーブルの詳細については、「about_Hash_Tables (ハッシュ テーブルについて)」をご覧ください。
ハッシュ テーブルで使用される Status プロパティは列挙プロパティです。 詳細については、「 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
コマンドレットは Get-Service
、コンピューター上のサービスの一覧を取得します。 サービス オブジェクトは、パイプラインから コマンドレットに Sort-Object
送信されます。 Sort-Object
では、 Property パラメーターとハッシュ テーブルを使用して、プロパティ名と並べ替え順序を指定します。 Property パラメーターは、Status という 2 つのプロパティで降順に並べ替え、DisplayName を昇順で並べ替えます。
Status は列挙プロパティです。 Stopped の値は 1 で、 Running の値は 4 です。 [実行中のプロセス] が [停止済みプロセス] の前に表示されるように、Descending パラメーターが に$True
設定されています。 DisplayName は 、表示名をアルファベット順に並べ替えるために 、Descending パラメーターを に $False
設定します。
例 6: 期間別にテキスト ファイルを並べ替える
このコマンドは、 CreationTime と 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
コマンドレットは Get-ChildItem
Path パラメーターを使用して、ディレクトリとすべてのファイルを*.txt
指定しますC:\Test
。 オブジェクトは、パイプラインから コマンドレットに Sort-Object
送信されます。
Sort-Object
では、 Scriptblock と共に Property パラメーターを使用して 、CreationTime と LastWriteTime の間の各ファイルの期間を決定します。
例 7: テキスト ファイル内の名前を並べ替える
この例では、テキスト ファイルからリストを並べ替える方法を示します。 元のファイルは、並べ替えられていないリストとして表示されます。 Sort-Object
は内容を並べ替え、重複を削除する Unique パラメーターを使用して内容を並べ替えます。
# 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
コマンドレットでは 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
各コマンドを送信し、オブジェクトが整数ではなく文字列であることを確認できます。 これらの例では、ファイルに ProductId.txt
製品番号の並べ替えされていないリストが含まれています。
最初の例では、 Get-Content
はファイルの内容を取得し、コマンドレットにパイプ行を Sort-Object
取得します。 Sort-Object
は、文字列オブジェクトを昇順で並べ替えます。
# 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
2 番目の例では、 Get-Content
は ファイルの内容を取得し、 コマンドレットに行を Sort-Object
パイプします。 Sort-Object
では、スクリプト ブロックを使用して文字列を整数に変換します。 サンプル コードでは、文字列を整数に変換し、 [int]
$_
パイプラインの下にある各文字列を表します。 整数オブジェクトは、パイプラインからコマンドレットに Sort-Object
送信されます。
Sort-Object
は、整数オブジェクトを数値順に並べ替えます。
例 9: 安定した並べ替えを使用する
Top、Bottom、または Stable パラメーターを使用すると、並べ替えられたオブジェクトは、並べ替え条件が等しいときに受信した順序でSort-Object
配信されます。 この例では、数値 1 から 20 を値 'modulo 3' で並べ替えています。 剰余値の範囲は 0 から 2 です。
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
最初の並べ替えからの出力は、剰余値で正しくグループ化されますが、個々の項目は剰余範囲内で並べ替えされません。 2 番目の並べ替えでは、 Stable オプションを使用して安定した並べ替えを返します。
例 10: 複数のプロパティで並べ替える
複数のプロパティで並べ替える場合は、プロパティをコンマで区切ります。
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
コマンドレットは Get-ChildItem
、 Path パラメーターで指定されたディレクトリからファイルを取得します。 オブジェクトは、パイプラインから コマンドレットに Sort-Object
送信されます。 Sort-Object
では、 Length パラメーターと Name パラメーターを使用して、ファイルを長さ順に並べ替えます。 と の長さは同じであるためFile01.txt
、プロパティ Name でさらに並べ替えられます。File03.txt
パラメーター
-Bottom
並べ替えられたオブジェクト配列の末尾から取得するオブジェクトの数を指定します。 これにより、安定した並べ替えが行われます。
このパラメーターは、PowerShell 6.0 で導入されました。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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
示します。 既定値は昇順です。
異なる並べ替え順序で複数のプロパティを並べ替えるには、ハッシュ テーブルを使用します。 たとえば、ハッシュ テーブルを使用すると、1 つのプロパティを昇順で並べ替え、別のプロパティを降順で並べ替えることができます。
Type: | SwitchParameter |
Position: | Named |
Default value: | Ascending |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
オブジェクトを並べ替えるには、パイプラインを に Sort-Object
送信します。 InputObject パラメーターを使用して項目のコレクションを送信する場合は、Sort-Object
コレクションを表す 1 つのオブジェクトを受け取ります。 1 つのオブジェクトを並べ替えできないため、 Sort-Object
コレクション全体を変更せずに返します。
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Property
オブジェクトの並べ替えに使用する Sort-Object
プロパティ名を指定します。 ワイルドカードを使用できます。
オブジェクトは、プロパティ値に基づいて並べ替えられます。 プロパティを指定しない場合は、 Sort-Object
オブジェクトの種類またはオブジェクト自体の既定のプロパティに基づいて並べ替えます。
複数のプロパティを区切るには、コンマを使用します。 複数のプロパティは、昇順、降順、または並べ替え順序の組み合わせで並べ替えることができます。 複数のプロパティを指定すると、オブジェクトは最初のプロパティで並べ替えられます。 複数のオブジェクトが最初のプロパティに同じ値を持つ場合、それらのオブジェクトは 2 番目のプロパティで並べ替えられます。 指定されたプロパティがなくなるか、またはオブジェクトのグループがなくなるまで、このプロセスが続行されます。
Property パラメーターの値には、計算プロパティを指定できます。 計算プロパティを作成するには、scriptblock またはハッシュテーブルを使用します。
ハッシュ テーブルの有効なキーは次のとおりです。
expression
-<string>
または<script block>
ascending
またはdescending
-<boolean>
詳細については、「 about_Calculated_Properties」を参照してください。
Type: | Object[] |
Position: | 0 |
Default value: | Default properties |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Stable
並べ替えられたオブジェクトは、並べ替え条件が等しいときに受信した順序で配信されます。
このパラメーターは、PowerShell v6.2.0 で追加されました。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Top
並べ替えられたオブジェクト配列の先頭から取得するオブジェクトの数を指定します。 これにより、安定した並べ替えが行われます。
このパラメーターは、PowerShell 6.0 で導入されました。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Unique
重複を排除し、コレクションの一意のメンバーのみを返す を Sort-Object
示します。 並べ替えられた出力には、一意の値の最初のインスタンスが含まれます。
Unique では大文字と小文字が区別されません。 文字の大文字と小文字のみが異なる文字列は同じと見なされます。 たとえば、character や CHARACTER などです。
Type: | SwitchParameter |
Position: | Named |
Default value: | All |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
並べ替えられるオブジェクトを にパイプできます Sort-Object
。
出力
Sort-Object
は、並べ替えられたオブジェクトを返します。
メモ
コマンドレットは Sort-Object
、 コマンドで指定されたプロパティまたはオブジェクト型の既定の並べ替えプロパティに基づいてオブジェクトを並べ替えます。 既定の並べ替えプロパティは、ファイル内の types.ps1xml
名前付き DefaultKeyPropertySet
をPropertySet
使用して定義されます。 詳細については、「 about_Types.ps1xml」を参照してください。
オブジェクトに指定されたプロパティのいずれかが含まれていない場合、そのオブジェクトのプロパティ値は Null として解釈されSort-Object
、並べ替え順序の最後に配置されます。
並べ替えプロパティが使用できない場合、PowerShell はオブジェクト自体の比較を試みます。
Sort-Object
では、各プロパティに 対して Compare メソッドを使用します。 プロパティが IComparable を実装していない場合、コマンドレットはプロパティ値を文字列に変換し、System.String に Compare メソッドを使用します。 詳細については、「 PSObject.CompareTo(Object) メソッド」を参照してください。
Status などの列挙プロパティで並べ替える場合は、Sort-Object
列挙値で並べ替えます。 Windows サービスの場合、 Stopped の値は 1 、 Running の値は 4 です。
Stopped は、列挙値のため 、実行中 の前に並べ替えられます。 詳細については、「 ServiceControllerStatus」を参照してください。
安定した並べ替えを実行すると、並べ替えアルゴリズムのパフォーマンスが低下します。