Sort-Object
Classifica objetos por valores de propriedade.
Sintaxe
Default (Default)
Sort-Object
[[-Property] <Object[]>]
[-Descending]
[-Unique]
[-InputObject <psobject>]
[-Culture <string>]
[-CaseSensitive]
[<CommonParameters>]
Description
O cmdlet Sort-Object classifica objetos em ordem crescente ou decrescente com base nos valores da propriedade do objeto. Se as propriedades de classificação não estiverem incluídas em um comando, o PowerShell usará as propriedades de classificação padrão.
Você pode classificar objetos por uma única propriedade ou várias propriedades. Várias propriedades usam tabelas de hash para classificar em ordem crescente, ordem decrescente ou uma combinação de ordens de classificação. As propriedades são classificadas como diferenciais de maiúsculas de minúsculas ou que não diferenciam maiúsculas de minúsculas. Use o parâmetro Unique para eliminar duplicatas da saída.
Exemplos
Exemplo 1: classificar o diretório atual por nome
Este comando classifica os arquivos e subdiretórios em um diretório.
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
O Get-ChildItem cmdlet obtém os arquivos e subdiretórios do diretório especificado pelo parâmetro Path , C:\Test. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object não especifica uma propriedade, portanto, a saída é classificada pela propriedade de classificação padrão, Name.
Exemplo 2: classificar o diretório atual por comprimento do arquivo
Esse comando exibe os arquivos no diretório atual por comprimento em ordem crescente.
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
O cmdlet Get-ChildItem obtém os arquivos do diretório especificado pelo parâmetro caminho.
O parâmetro File especifica que Get-ChildItem obtém apenas objetos de arquivo. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro Length para classificar os arquivos por comprimento em ordem crescente.
Exemplo 3: classificar processos por uso de memória
Este exemplo exibe processos com o maior uso de memória com base no tamanho do conjunto de trabalho (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
O cmdlet Get-Process obtém a lista de processos em execução no computador. Os objetos de processo são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro propriedade para classificar os objetos WS. Os objetos são enviados pelo pipeline para o cmdlet Select-Object.
Select-Object usa o parâmetro Last para especificar os últimos cinco objetos, que são os objetos com o maior uso de do WS.
Exemplo 4: Classificar objetos HistoryInfo por Id
Esse comando classifica os objetos HistoryInfo da sessão do PowerShell usando a propriedade de ID de. Cada sessão do PowerShell tem seu próprio histórico de comandos.
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\
O cmdlet Get-History obtém os objetos de histórico da sessão atual do PowerShell. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro Property para classificar os objetos ID. O parâmetro Decrescente classifica o histórico de comandos do mais novo para o mais antigo.
Exemplo 5: Usar uma tabela de hash para classificar propriedades em ordem crescente e decrescente
Esse comando usa duas propriedades para classificar os objetos, Status e DisplayName. Status é classificado em ordem decrescente e DisplayName é classificado em ordem crescente.
Uma tabela de hash é usada para especificar o valor do parâmetro Property. A tabela de hash usa uma expressão para especificar os nomes de propriedade e as ordens de classificação. Para obter informações sobre tabelas de hash, confira about_Hash_Tables.
A propriedade Status usada na tabela de hash é uma propriedade enumerada. Para obter mais informações, consulte 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
O cmdlet Get-Service obtém a lista de serviços no computador. Os objetos de serviço são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro Property com uma tabela de hash para especificar os nomes de propriedade e os pedidos de classificação. O parâmetro de Propriedade é classificado por duas propriedades, status em ordem decrescente e DisplayName em ordem crescente.
Status é uma propriedade enumerada.
Stopped tem um valor de 1 e Running tem um valor de 4. O parâmetro Decrescente é definido como $True para que processos de em execução sejam exibidos antes de processos de interrompidos.
DisplayName define o parâmetro Decrescente para $False para classificar os nomes de exibição em ordem alfabética.
Exemplo 6: Classificar arquivos de texto por intervalo de tempo
Esse comando classifica arquivos de texto em ordem decrescente pelo intervalo de tempo entre CreationTime e 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
O Get-ChildItem cmdlet usa o parâmetro Path para especificar o diretório C:\Test e todos os *.txt arquivos. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro Property com uma tabela de hash para determinar o intervalo de tempo de cada arquivo entre CreationTime e LastWriteTime. O parâmetro Descending é definido como $False para classificar na ordem do maior para o menor intervalo de tempo.
Exemplo 7: Classificar nomes em um arquivo de texto
Este exemplo mostra como classificar uma lista de um arquivo de texto. O arquivo original é exibido como uma lista não classificada.
Sort-Object classifica o conteúdo e, em seguida, classifica o conteúdo com o parâmetro Exclusivo que remove duplicatas.
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
O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O ServerNames.txt de arquivos contém uma lista não classificada de nomes de computadores.
O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O ServerNames.txt de arquivos contém uma lista não classificada de nomes de computadores. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object classifica a lista na ordem padrão, em ordem crescente.
O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O ServerNames.txt de arquivos contém uma lista não classificada de nomes de computadores. Os objetos são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object usa o parâmetro Unique para remover nomes de computador duplicados. A lista é classificada na ordem padrão, crescente.
Exemplo 8: Classificar uma cadeia de caracteres como um inteiro
Este exemplo mostra como classificar um arquivo de texto que contém objetos de cadeia de caracteres como inteiros. Você pode enviar cada comando pelo pipeline e Get-Member verificar se os objetos são cadeias de caracteres ou inteiros.
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
O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O ProductId.txt de arquivo contém uma lista não classificada de números de produto. Os objetos de cadeia de caracteres são enviados pelo pipeline para o Sort-Object cmdlet.
Sort-Object classifica os objetos de cadeia de caracteres em ordem crescente.
O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O ProductId.txt de arquivo contém uma lista não classificada de números de produto. Os objetos de cadeia de caracteres são enviados pelo pipeline para o ForEach-Object cmdlet.
ForEach-Object usa um bloco de script para converter as cadeias de caracteres em inteiros. No código de exemplo, [int] converte a cadeia de caracteres em um inteiro e $_ representa cada cadeia de caracteres conforme ela desce o pipeline. Os objetos inteiros são enviados pelo pipeline para o cmdlet Sort-Object.
Sort-Object classifica os objetos inteiros em ordem numérica.
Parâmetros
-CaseSensitive
Indica que a classificação diferencia maiúsculas de minúsculas. Por padrão, as classificações não diferenciam maiúsculas de minúsculas.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | Case-insensitive |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Culture
Especifica a configuração cultural a ser usada para classificações. Use Get-Culture para exibir a configuração de cultura do sistema.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Descending
Indica que Sort-Object classifica os objetos em ordem decrescente. O padrão é a ordem crescente.
Para classificar várias propriedades com ordens de classificação diferentes, use uma tabela de hash. Por exemplo, com uma tabela de hash, você pode classificar uma propriedade em ordem crescente e outra em ordem decrescente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | Ascending |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InputObject
Para classificar objetos, envie-os pelo pipeline para Sort-Object. Se você usar o parâmetro InputObject para enviar uma coleção de itens, Sort-Object receberá um objeto que representa a coleção. Como um objeto não pode ser classificado, Sort-Object retorna toda a coleção inalterada.
Propriedades do parâmetro
| Tipo: | PSObject |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Property
Especifica os nomes de propriedade que Sort-Object usa para classificar os objetos. Caracteres curinga são permitidos.
Os objetos são classificados com base nos valores da propriedade. Se você não especificar uma propriedade, Sort-Object classificará com base nas propriedades padrão do tipo de objeto.
Várias propriedades podem ser classificadas em ordem crescente, ordem decrescente ou uma combinação de ordens de classificação. Quando você especifica várias propriedades, os objetos são classificados pela primeira propriedade. Se vários objetos tiverem o mesmo valor para a primeira propriedade, esses objetos serão classificados pela segunda propriedade. Esse processo continua até que não haja mais propriedades especificadas ou nenhum grupo de objetos.
O valor da propriedade parâmetro pode ser uma propriedade calculada. Para criar uma propriedade calculada, use uma tabela de hash.
As chaves válidas para uma tabela de hash são as seguintes:
- Expressão <cadeia de caracteres> ou <bloco de script>
- Booleano Ascendente <>
- Booleano descendente <>
Propriedades do parâmetro
| Tipo: | Object[] |
| Valor padrão: | Default properties |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Unique
Indica que Sort-Object elimina duplicatas e retorna apenas os membros exclusivos da coleção. A primeira instância de um valor exclusivo é incluída na saída classificada.
Exclusivo não diferencia maiúsculas de minúsculas. Cadeias de caracteres que diferem apenas por caso de caractere são consideradas as mesmas. Por exemplo, caractere e CARACTERE.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | All |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSObject
Você pode canalizar os objetos a serem classificados para Sort-Object.
Saídas
PSObject
Sort-Object retorna os objetos classificados.
Observações
O cmdlet Sort-Object classifica objetos com base nas propriedades especificadas no comando ou nas propriedades de classificação padrão para o tipo de objeto. Se um objeto não tiver uma das propriedades especificadas, o valor da propriedade desse objeto será interpretado como Sort-ObjectNull e colocado no final da ordem de classificação.
Sort-Object usa o método Compare para cada propriedade. Se uma propriedade não implementar IComparable, o cmdlet converterá o valor da propriedade em uma cadeia de caracteres e usará o método Compare para System.String. Para obter mais informações, consulte método PSObject.CompareTo(Object).
Se você classificar em uma propriedade enumerada, como Status, Sort-Object classifica pelos valores de enumeração.
Stopped tem um valor de 1 e Running tem um valor de 4.
o Parado é classificado antes de Executando devido aos valores enumerados. Para obter mais informações, consulte ServiceControllerStatus.