Sort-Object

Référence

Module:: Microsoft.PowerShell.Utility

Trie les objets selon les valeurs de propriété.

Syntax

Sort-Object
    [[-Property] <Object[]>]
    [-Descending]
    [-Unique]
    [-InputObject <psobject>]
    [-Culture <string>]
    [-CaseSensitive]
    [<CommonParameters>]

Description

L’applet Sort-Object de commande trie les objets dans l’ordre croissant ou décroissant en fonction des valeurs des propriétés de l’objet. Si les propriétés de tri ne sont pas incluses dans une commande, PowerShell utilise les propriétés de tri par défaut.

Vous pouvez trier des objets selon une ou plusieurs propriétés. Plusieurs propriétés utilisent des tables de hachage pour trier dans l’ordre croissant, l’ordre décroissant ou une combinaison d’ordres de tri. Les propriétés sont triées en fonction de la casse ou de la casse. Utilisez le paramètre Unique pour éliminer les doublons de la sortie.

Exemples

Exemple 1 : Trier le répertoire actif par nom

Cette commande trie les fichiers et les sous-répertoires dans un répertoire.

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

L’applet Get-ChildItem de commande obtient les fichiers et les sous-répertoires du répertoire spécifié par le paramètre Path , C :\Test. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object ne spécifie pas de propriété de sorte que la sortie est triée par la propriété de tri par défaut, Name.

Exemple 2 : Trier le répertoire actif par longueur de fichier

Cette commande affiche les fichiers du répertoire actif par longueur dans l’ordre croissant.

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

L’applet Get-ChildItem de commande obtient les fichiers du répertoire spécifié par le paramètre Path . Le paramètre File spécifie que n’obtient que Get-ChildItem les objets fichier. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object utilise le paramètre Length pour trier les fichiers par longueur dans l’ordre croissant.

Exemple 3 : Trier les processus par utilisation de la mémoire

Cet exemple montre comment afficher les processus dont l’utilisation de mémoire est la plus élevée en fonction de leur taille de jeu de travail (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

L’applet Get-Process de commande obtient la liste des processus en cours d’exécution sur l’ordinateur. Les objets de processus sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande. Sort-Object utilise le paramètre Property pour trier les objets par WS. Les objets sont envoyés vers le bas du pipeline à l’applet de Select-Object commande . Select-Object utilise le paramètre Last pour spécifier les cinq derniers objets, qui sont les objets ayant l’utilisation WS la plus élevée.

Exemple 4 : Trier des objets HistoryInfo par ID

Cette commande trie les objets HistoryInfo de la session PowerShell à l’aide de la propriété Id . Chaque session PowerShell a son propre historique des commandes.

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\

L’applet Get-History de commande obtient les objets d’historique de la session PowerShell actuelle. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object utilise le paramètre Property pour trier les objets par Id. Le paramètre Décroissant trie l’historique des commandes du plus récent au plus ancien.

Exemple 5 : Utiliser une table de hachage pour trier les propriétés dans l’ordre croissant et décroissant

Cette commande utilise deux propriétés pour trier les objets, Status et DisplayName. L’état est trié dans l’ordre décroissant et DisplayName est trié dans l’ordre croissant.

Une table de hachage est utilisée pour spécifier la valeur du paramètre Property . La table de hachage utilise une expression pour spécifier les noms de propriétés et les ordres de tri. Pour plus d’informations sur les tables de hachage, voir À propos des tables de hachage.

La propriété Status utilisée dans la table de hachage est une propriété énumérée. Pour plus d’informations, consultez 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

L’applet Get-Service de commande obtient la liste des services sur l’ordinateur. Les objets de service sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande. Sort-Object utilise le paramètre Property avec une table de hachage pour spécifier les noms de propriétés et les ordres de tri. Le paramètre Property est trié par deux propriétés , Status dans l’ordre décroissant et DisplayName dans l’ordre croissant.

Status est une propriété énumérée. Arrêté a la valeur 1 et Running a la valeur 4. Le paramètre Décroissant est défini sur $True afin que les processus en cours d’exécution soient affichés avant les processus arrêtés . DisplayName définit le paramètre Décroissant sur $False pour trier les noms d’affichage dans l’ordre alphabétique.

Exemple 6 : Trier les fichiers texte par intervalle de temps

Cette commande trie les fichiers texte dans l’ordre décroissant selon l’intervalle de temps entre CreationTime et 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

L’applet Get-ChildItem de commande utilise le paramètre Path pour spécifier le répertoire C :\Test et tous les *.txt fichiers. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object utilise le paramètre Property avec une table de hachage pour déterminer chaque intervalle de temps de fichiers entre CreationTime et LastWriteTime. Le paramètre Décroissant est défini sur $False pour trier dans l’ordre de l’intervalle de temps le plus long au plus court.

Exemple 7 : Trier les noms dans un fichier texte

Cet exemple montre comment trier une liste à partir d’un fichier texte. Le fichier d’origine s’affiche sous la forme d’une liste non triée. Sort-Object trie le contenu, puis trie le contenu avec le paramètre Unique qui supprime les doublons.

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

L’applet Get-Content de commande utilise le paramètre Path pour spécifier le répertoire et le nom de fichier. Le fichier ServerNames.txt contient une liste non triée de noms d’ordinateurs. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object trie la liste dans l’ordre par défaut, croissant.

L’applet Get-Content de commande utilise le paramètre Path pour spécifier le répertoire et le nom de fichier. Le fichier ServerNames.txt contient une liste non triée de noms d’ordinateurs. Les objets sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande . Sort-Object utilise le paramètre Unique pour supprimer les noms d’ordinateurs en double. La liste est triée dans l’ordre par défaut, croissant.

Exemple 8 : trier une chaîne en tant qu’entier

Cet exemple montre comment trier un fichier texte qui contient des objets de chaîne sous forme d’entiers. Vous pouvez envoyer chaque commande dans le pipeline et Get-Member vérifier que les objets sont des chaînes ou des entiers.

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

L’applet Get-Content de commande utilise le paramètre Path pour spécifier le répertoire et le nom de fichier. Le fichier ProductId.txt contient une liste de numéros de produit non triés. Les objets de chaîne sont envoyés vers le bas du pipeline à l’applet de ForEach-Object commande. ForEach-Object utilise un bloc de script pour convertir les chaînes en entiers. Dans l’exemple de code, [int] convertit la chaîne en entier et $_ représente chaque chaîne à mesure qu’elle descend du pipeline. Les objets entiers sont envoyés vers le bas du pipeline à l’applet de Sort-Object commande. Sort-Object trie les objets entiers dans l’ordre numérique.

Paramètres

-CaseSensitive

Indique que le tri respecte la casse. Par défaut, les tris ne respectent pas la casse.

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

-Culture

Spécifie la configuration culturelle à utiliser pour les tris. Permet Get-Culture d’afficher la configuration de culture du système.

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

-Descending

Indique que Sort-Object trie les objets dans l’ordre décroissant. La valeur par défaut est l'ordre croissant.

Pour trier plusieurs propriétés avec des ordres de tri différents, utilisez une table de hachage. Par exemple, avec une table de hachage, vous pouvez trier une propriété dans l’ordre croissant et une autre propriété dans l’ordre décroissant.

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

-InputObject

Pour trier des objets, envoyez-les dans le pipeline à Sort-Object. Si vous utilisez le paramètre InputObject pour envoyer une collection d’éléments, Sort-Object reçoit un objet qui représente la collection. Étant donné qu’un objet ne peut pas être trié, Sort-Object retourne la collection entière inchangée.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Property

Spécifie les noms de propriétés qui Sort-Object utilisent pour trier les objets. Les caractères génériques sont autorisés. Les objets sont triés en fonction des valeurs de propriété. Si vous ne spécifiez pas de propriété, Sort-Object trie en fonction des propriétés par défaut du type d’objet.

Plusieurs propriétés peuvent être triées dans l’ordre croissant, décroissant ou dans une combinaison d’ordres de tri. Lorsque vous spécifiez plusieurs propriétés, les objets sont triés par la première propriété. Si plusieurs objets ont la même valeur pour la première propriété, ces objets sont triés par la deuxième propriété. Ce processus se poursuit jusqu'à ce qu'il ne reste plus aucune propriété spécifiée ou aucun groupe d'objets.

La valeur du paramètre Property peut être une propriété calculée. Pour créer une propriété calculée, utilisez une table de hachage.

Les clés valides pour une table de hachage sont les suivantes :

Chaîne d’expression <> ou <bloc de script>
Boolean croissant <>
Booléen décroissant <>

Type:	Object[]
Position:	0
Default value:	Default properties
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Unique

Indique que Sort-Object supprime les doublons et retourne uniquement les membres uniques de la collection. La première instance d’une valeur unique est incluse dans la sortie triée.

Unique ne respecte pas la casse. Les chaînes qui diffèrent uniquement par la casse de caractères sont considérées comme identiques. Par exemple, caractère et CARACTÈRE.

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

Entrées

PSObject

Vous pouvez diriger les objets à trier vers Sort-Object.

Sorties

PSObject

Sort-Object retourne les objets triés.

Notes

L’applet Sort-Object de commande trie les objets en fonction des propriétés spécifiées dans la commande ou des propriétés de tri par défaut pour le type d’objet. Si un objet n’a pas l’une des propriétés spécifiées, la valeur de propriété de cet objet est interprétée par Sort-Object comme Null et placée à la fin de l’ordre de tri.

Sort-Object utilise la méthode Compare pour chaque propriété. Si une propriété n’implémente pas IComparable, l’applet de commande convertit la valeur de la propriété en chaîne et utilise la méthode Compare pour System.String. Pour plus d’informations, consultez Méthode PSObject.CompareTo(Object).

Si vous effectuez un tri sur une propriété énumérée telle que Status, Sort-Object trie selon les valeurs d’énumération. Arrêté a la valeur 1 et En cours d’exécution a la valeur 4. Arrêté est trié avant l’exécution en raison des valeurs énumérées. Pour plus d’informations, consultez ServiceControllerStatus.

Partager via

Sort-Object

Syntax

Description

Exemples

Exemple 1 : Trier le répertoire actif par nom

Exemple 2 : Trier le répertoire actif par longueur de fichier

Exemple 3 : Trier les processus par utilisation de la mémoire

Exemple 4 : Trier des objets HistoryInfo par ID

Exemple 5 : Utiliser une table de hachage pour trier les propriétés dans l’ordre croissant et décroissant

Exemple 6 : Trier les fichiers texte par intervalle de temps

Exemple 7 : Trier les noms dans un fichier texte

Exemple 8 : trier une chaîne en tant qu’entier

Paramètres

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Unique

Entrées

Sorties

Notes

Ressources supplémentaires

Partager via

Sort-Object

Syntax

Description

Exemples

Exemple 1 : Trier le répertoire actif par nom

Exemple 2 : Trier le répertoire actif par longueur de fichier

Exemple 3 : Trier les processus par utilisation de la mémoire

Exemple 4 : Trier des objets HistoryInfo par ID

Exemple 5 : Utiliser une table de hachage pour trier les propriétés dans l’ordre croissant et décroissant

Exemple 6 : Trier les fichiers texte par intervalle de temps

Exemple 7 : Trier les noms dans un fichier texte

Exemple 8 : trier une chaîne en tant qu’entier

Paramètres

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Unique

Entrées

Sorties

Notes

Liens associés

Ressources supplémentaires