Sort-Object

モジュール:

Microsoft.PowerShell.Utility

プロパティ値別にオブジェクトを並べ替えます。

構文

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:\TestPath パラメーターで指定されたディレクトリからファイルとサブディレクトリを取得します。 オブジェクトは、パイプラインからコマンドレットに 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: ハッシュ テーブルを使用してプロパティを昇順と降順で並べ替える

この例では、2 つのプロパティを使用して、 Status と DisplayName の 2 つのオブジェクトを並べ替えます。 状態 は降順に並べ替え、 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 パラメーターは、2 つのプロパティで並べ替えられます。Status は降順で、DisplayName は昇順で並べ替えられます。

Status は列挙プロパティです。 Stopped の値は 1 で、 Running の値は 4 です。 Descending パラメーターは、実行中のプロセスが停止済みプロセスの前に表示されるように設定$Trueされています。 DisplayName は、表示名をアルファベット順に$False並べ替える Descending パラメーターを設定します。

例 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、プロパティ名でさらに並べ替えられます。File03.txt

パラメーター

-Bottom

並べ替えられたオブジェクト配列の末尾から取得するオブジェクトの数を指定します。 これにより、安定した並べ替えが行えます。

このパラメーターは、PowerShell 6.0 で導入されました。

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

-CaseSensitive

並べ替えが大文字と小文字を区別することを示します。 既定では、並べ替えでは大文字と小文字は区別されません。

Type:	SwitchParameter
Position:	Named
Default value:	Case-insensitive
Accept pipeline input:	False
Accept wildcard characters:	False

-Culture

並べ替えに使用するカルチャ構成を指定します。 システムのカルチャ構成を表示するために使用 Get-Culture します。

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

-Descending

オブジェクトを Sort-Object 降順で並べ替える方法を示します。 既定値は昇順です。

並べ替え順序が異なる複数のプロパティを並べ替えるには、ハッシュ テーブルを使用します。 たとえば、ハッシュ テーブルを使用すると、1 つのプロパティを昇順に並べ替え、別のプロパティを降順で並べ替えることができます。

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

-Stable

並べ替えられたオブジェクトは、並べ替え条件が等しいときに受信した順序で配信されます。

このパラメーターは、PowerShell v6.2.0 で追加されました。

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

-Top

並べ替えられたオブジェクト配列の先頭から取得するオブジェクトの数を指定します。 これにより、安定した並べ替えが行えます。

このパラメーターは、PowerShell 6.0 で導入されました。

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

-Unique

重複を Sort-Object 排除し、コレクションの一意のメンバーのみを返すを示します。 並べ替えられた出力には、一意の値の最初のインスタンスが含まれます。

Unique では、大文字と小文字は区別されません。 文字の大文字と小文字のみが異なる文字列は、同じと見なされます。 たとえば、文字や CHARACTER などです。

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

入力

PSObject

並べ替えの対象となるオブジェクトをパイプ処理 Sort-Objectできます。

出力

PSObject

Sort-Object は、並べ替えられたオブジェクトを返します。

メモ

コマンドレットは Sort-Object 、コマンドで指定されたプロパティまたはオブジェクトの種類の既定の並べ替えプロパティに基づいてオブジェクトを並べ替えます。 既定の並べ替えプロパティは、ファイル内のPropertySettypes.ps1xml名前付きDefaultKeyPropertySetを使用して定義されます。 詳細については、「 about_Types.ps1xml」を参照してください。

オブジェクトに指定されたプロパティがない場合、そのオブジェクトのプロパティ値は Null として解釈されSort-Object、並べ替え順序の最後に配置されます。

並べ替えプロパティが使用できない場合、PowerShell はオブジェクト自体の比較を試みます。 Sort-Object では、各プロパティの Compare メソッドを使用します。 プロパティが IComparable を実装していない場合、コマンドレットはプロパティ値を文字列に変換し、System.String の Compare メソッドを使用します。 詳細については、 PSObject.CompareTo(Object) メソッドを参照してください。

Status などの列挙プロパティで並べ替える場合は、Sort-Object列挙値で並べ替えます。 Windows サービスの場合、 Stopped の値は 1 で、 実行中 の値は 4 です。 停止した 値は、列挙値のため 、実行中 より前に並べ替えられます。 詳細については、「 ServiceControllerStatus」を参照してください。

並べ替えアルゴリズムのパフォーマンスは、安定した並べ替えを行うときに遅くなります。

関連リンク

• about_Calculated_Properties
• about_Hash_Tables
• about_Types.ps1xml
• Compare-Object
• ForEach-Object
• Group-Object
• Measure-Object
• New-Object
• Select-Object
• Tee-Object