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 では、パラメーター Bottom Sort-Object は Select-Object. たとえば、Get-Process | Sort-Object -Property WS -Bottom 5 のようにします。

例 4: HistoryInfo オブジェクトを ID で並べ替える

このコマンドは、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 です。状態は降順 で並べ替えられます。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 パラメーターは、2 つのプロパティで並べ替えられます。Status は降順で、DisplayName は昇順で並べ替えられます。

Status は列挙プロパティです。 Stopped の値 は 1 で、 Running の値 は 4 です。 停止したプロセスの前に$True実行中のプロセスが表示されるように、Descending パラメーターが設定されています。 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 パラメーターを使用して、ファイルを長さで昇順に並べ替えます。 File03.txt長さが同じであるためFile01.txt、プロパティ Name でさらに並べ替えられます。

例 11: キー値でハッシュテーブルを並べ替える

PowerShell 6 以降では、Sort-Objectキー値によるハッシュテーブル入力の並べ替えがサポートされています。次の例では、ハッシュテーブルの配列を各ハッシュテーブル weight のキーの値で並べ替えます。

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

パラメーター

-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 などです。

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

入力

PSObject

このコマンドレットに並べ替えるオブジェクトをパイプ処理できます。

出力

PSObject

このコマンドレットは、並べ替えられたオブジェクトを返します。

メモ

PowerShell には、次のエイリアスが Sort-Object含まれています。

Windows:
- sort

コマンドレットは Sort-Object 、コマンドで指定されたプロパティまたはオブジェクトの種類の既定の並べ替えプロパティに基づいてオブジェクトを並べ替えます。既定の並べ替えプロパティは、ファイル内の名前付きDefaultKeyPropertySetプロパティPropertySetをtypes.ps1xml使用して定義されます。詳細については、「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 です。 停止は、列挙値のため、実行中より前に並べ替えられます。詳細については、「ServiceControllerStatus」を参照してください。

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

Sort-Object

構文

説明

例

例 1: 現在のディレクトリを名前で並べ替える

例 2: 現在のディレクトリをファイル長で並べ替える

例 3: メモリ使用量でプロセスを並べ替える

例 4: HistoryInfo オブジェクトを ID で並べ替える

例 5: ハッシュテーブルを使用してプロパティを昇順および降順で並べ替える

例 6: 期間でテキストファイルを並べ替える

例 7: テキストファイル内の名前を並べ替える

例 8: 文字列を整数として並べ替える

例 9: 安定した並べ替えを使用する

例 10: 複数のプロパティで並べ替える

例 11: キー値でハッシュテーブルを並べ替える

パラメーター

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

入力

出力

メモ

フィードバック

その他のリソース

Sort-Object

構文

説明

例

例 1: 現在のディレクトリを名前で並べ替える

例 2: 現在のディレクトリをファイル長で並べ替える

例 3: メモリ使用量でプロセスを並べ替える

例 4: HistoryInfo オブジェクトを ID で並べ替える

例 5: ハッシュ テーブルを使用してプロパティを昇順および降順で並べ替える

例 6: 期間でテキスト ファイルを並べ替える

例 7: テキスト ファイル内の名前を並べ替える

例 8: 文字列を整数として並べ替える

例 9: 安定した並べ替えを使用する

例 10: 複数のプロパティで並べ替える

例 11: キー値でハッシュテーブルを並べ替える

パラメーター

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

入力

出力

メモ

関連リンク

フィードバック

その他のリソース

例 5: ハッシュテーブルを使用してプロパティを昇順および降順で並べ替える

例 6: 期間でテキストファイルを並べ替える

例 7: テキストファイル内の名前を並べ替える