Sort-Object
Trie les objets par valeurs de propriété.
Syntaxe
Default (Par défaut)
Sort-Object
[[-Property] <Object[]>]
[-Descending]
[-Unique]
[-InputObject <psobject>]
[-Culture <string>]
[-CaseSensitive]
[<CommonParameters>]
Description
L’applet Sort-Object de commande trie les objets par ordre croissant ou décroissant en fonction des valeurs des propriétés d’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 les objets en fonction d’une seule propriété ou de plusieurs propriétés. Plusieurs propriétés utilisent des tables de hachage pour trier par ordre croissant, par ordre décroissant ou par une combinaison d’ordres de tri. Les propriétés sont triées selon qu’elles sont sensibles à la casse ou non. Utilisez le paramètre Unique pour éliminer les doublons de la sortie.
Exemples
Exemple 1 : Trier le répertoire actuel par nom
Cette commande trie les fichiers et les sous-répertoires d’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 extrait les fichiers et les sous-répertoires du répertoire spécifié par le paramètre Path , C :\Test. Les objets sont envoyés au pipeline à l’applet de commande Sort-Object.
Sort-Object ne spécifie pas de propriété, de sorte que la sortie est triée en fonction de la propriété de tri par défaut, Nom.
Exemple 2 : Trier le répertoire actuel par longueur de fichier
Cette commande affiche les fichiers du répertoire courant 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 récupère les fichiers à partir du répertoire spécifié par le paramètre Path .
Le paramètre File spécifie que n’obtient Get-ChildItem que les objets file. Les objets sont envoyés au pipeline à l’applet de commande Sort-Object.
Sort-Object utilise le paramètre Length pour trier les fichiers par longueur dans l’ordre croissant.
Exemple 3 : Trier les processus en fonction de l’utilisation de la mémoire
Cet exemple affiche les processus dont l’utilisation de la mémoire est la plus élevée en fonction de la taille de leur plage de travail.
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 récupère la liste des processus en cours d’exécution sur l’ordinateur. Les objets de processus sont envoyés dans le pipeline vers l’applet Sort-Object de commande.
Sort-Objectutilise le paramètre Property pour trier les objets par WS. Les objets sont envoyés au pipeline à l’applet de commande Select-Object.
Select-Object utilise le paramètre Last pour spécifier les cinq derniers objets, qui sont les objets dont l’utilisation WS est la plus élevée.
Exemple 4 : Trier les 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 de 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 récupère les objets d’historique de la session PowerShell en cours. Les objets sont envoyés au pipeline à l’applet de commande Sort-Object.
Sort-Object utilise le paramètre Property pour trier les objets par Id. Le paramètre Décroissant trie l’historique des commandes de la plus récente à la plus ancienne.
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é par ordre décroissant et DisplayName est trié par 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é 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 récupère la liste des services sur l’ordinateur. Les objets de service sont envoyés dans le pipeline vers l’applet Sort-Object de commande.
Sort-Object utilise le paramètre Property avec une table de hachage pour spécifier les noms de propriété 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.
Stopped a la valeur 1 etRunning a la valeur 4. Le paramètre Décroissant est défini de $True sorte 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 pour $False trier les noms d’affichage par ordre alphabétique.
Exemple 6 : Trier les fichiers texte par période
Cette commande trie les fichiers texte par ordre décroissant en fonction de 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 au pipeline à l’applet de commande Sort-Object.
Sort-Object utilise le paramètre Property avec une table de hachage pour déterminer l’intervalle de temps de chaque fichier entre CreationTime et LastWriteTime. Le paramètre Décroissant est défini pour $False trier dans l’ordre de la période la plus longue à la plus courte.
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 à l’aide du 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.
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 au pipeline à l’applet de commande Sort-Object.
Sort-Object Trie la liste dans l’ordre par défaut, par ordre 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 au pipeline à l’applet de commande Sort-Object.
Sort-Object utilise le paramètre Unique pour supprimer les noms d’ordinateur en double. La liste est triée dans l’ordre par défaut, par ordre croissant.
Exemple 8 : Trier une chaîne en tant qu’entier
Cet exemple montre comment trier un fichier texte contenant des objets chaîne sous forme d’entiers. Vous pouvez envoyer chaque commande dans le pipeline Get-Member et 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 contientProductId.txt une liste non triée de numéros de produit. Les objets string sont envoyés dans le pipeline vers l’applet Sort-Object de commande.
Sort-Object Trie les objets de chaîne dans l’ordre 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 contientProductId.txt une liste non triée de numéros de produit. Les objets string sont envoyés dans le pipeline vers l’applet ForEach-Object de commande.
ForEach-Object Utilise un bloc de script pour convertir les chaînes en nombres entiers. Dans l’exemple de code, [int] convertit la chaîne en un entier et représente chaque chaîne au fur et $_ à mesure qu’elle descend dans le pipeline. Les objets entiers sont envoyés dans le pipeline vers l’applet Sort-Object de commande.
Sort-Object Trie les objets entiers dans l’ordre numérique.
Paramètres
-CaseSensitive
Indique que le tri est sensible à la casse. Par défaut, les tris ne sont pas sensibles à la casse.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | Case-insensitive |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Culture
Spécifie la configuration culturelle à utiliser pour les tris. Permet Get-Culture d’afficher la configuration de culture du système.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Descending
Indique que Sort-Object trie les objets par 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | Ascending |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Pour trier les objets, envoyez-les dans le pipeline à Sort-Object. Si vous utilisez le paramètre InputObject pour soumettre 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 renvoie la collection entière inchangée.
Propriétés du paramètre
| Type: | PSObject |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Property
Spécifie les noms de propriété utilisés Sort-Object 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 par ordre croissant, par ordre décroissant ou par une combinaison d’ordres de tri. Lorsque vous spécifiez plusieurs propriétés, les objets sont triés en fonction de la première propriété. Si plusieurs objets ont la même valeur pour la première propriété, ces objets sont triés en fonction de la deuxième propriété. Ce processus se poursuit jusqu’à ce qu’il n’y ait plus de propriétés spécifiées ou plus de groupes 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 :
- < de bloc de script >chaîne< ou >
- Booléen croissant <>
- Booléen décroissant <>
Propriétés du paramètre
| Type: | Object[] |
| Valeur par défaut: | Default properties |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Unique
Indique que Sort-Object élimine les doublons et renvoie uniquement les membres uniques de la collection. La première instance d’une valeur unique est incluse dans la sortie triée.
Unique n’est pas sensible à la casse. Les chaînes qui ne diffèrent que par la casse des caractères sont considérées comme identiques. Par exemple, character et CHARACTER.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | All |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
PSObject
Vous pouvez rediriger les objets à trier vers Sort-Object.
Sorties
PSObject
Sort-Object Renvoie 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 du 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 la section Méthode PSObject.CompareTo(Object).
Si vous effectuez un tri sur une propriété énumérée telle que Status, Sort-Object triez en fonction des valeurs d’énumération.
Stopped a la valeur 1 etRunning a la valeur 4.
Arrêté est trié avant Exécution en raison des valeurs énumérées. Pour plus d’informations, consultez ServiceControllerStatus.