Sort-Object

Referência

Módulo:: Microsoft.PowerShell.Utility

Classifica os objetos por valores de propriedade.

Syntax

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>]

Description

O Sort-Object cmdlet 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 do primeiro objeto de entrada. Se o tipo do objeto de entrada não tiver propriedades de classificação padrão, o PowerShell tentará comparar os próprios objetos. Para obter mais informações, veja a seção Observações.

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 sensíveis a 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 exemplo 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 Sort-Object cmdlet . Sort-Object não especifica uma propriedade para que a saída seja 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 Get-ChildItem cmdlet obtém os arquivos do diretório especificado pelo parâmetro Path . O parâmetro File especifica que Get-ChildItem só obtém objetos de arquivo. Os objetos são enviados pelo pipeline para o Sort-Object cmdlet . 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 WS (conjunto de trabalho).

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 Get-Process cmdlet obtém a lista de processos em execução no computador. Os objetos de processo são enviados pelo pipeline para o Sort-Object cmdlet . Sort-Object usa o parâmetro Property para classificar os objetos por WS. Os objetos são enviados pelo pipeline para o Select-Object cmdlet . Select-Object usa o último parâmetro para especificar os últimos cinco objetos, que são os objetos com o maior uso do WS .

No PowerShell 6, o Sort-Object parâmetro Bottom é uma alternativa a Select-Object. Por exemplo, Get-Process | Sort-Object -Property WS -Bottom 5.

Exemplo 4: Classificar objetos HistoryInfo por Id

Esse comando classifica os objetos HistoryInfo da sessão do PowerShell usando a propriedade Id . 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 Get-History cmdlet obtém os objetos de histórico da sessão atual do PowerShell. Os objetos são enviados pelo pipeline para o Sort-Object cmdlet . Sort-Object usa o parâmetro Property para classificar os objetos por Id. O parâmetro Descending 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

Este exemplo usa duas propriedades para classificar os objetos, Status e DisplayName. O 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 Get-Service cmdlet obtém a lista de serviços no computador. Os objetos de serviço são enviados pelo pipeline para o Sort-Object cmdlet . 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 Property é classificado por duas propriedades, Status em ordem decrescente e DisplayName em ordem crescente.

Status é uma propriedade enumerada. Parado tem um valor de 1 e Running tem um valor de 4. O parâmetro Decrescente é definido como para $True que os processos em execução sejam exibidos antes dos processos interrompidos . DisplayName define o parâmetro Descending como $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 Sort-Object cmdlet . Sort-Object usa o parâmetro Property com uma tabela de hash para determinar cada intervalo de tempo de arquivos entre CreationTime e LastWriteTime. O parâmetro Decrescente é definido como $False para classificar na ordem do período de tempo mais longo a curto.

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 classifica o conteúdo com o parâmetro Unique 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 arquivo ServerNames.txt contém uma lista não classificada de nomes de computador.

O Get-Content cmdlet usa o parâmetro Path para especificar o diretório e o nome do arquivo. O arquivo ServerNames.txt contém uma lista não classificada de nomes de computador. Os objetos são enviados pelo pipeline para o Sort-Object cmdlet . 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 arquivo ServerNames.txt contém uma lista não classificada de nomes de computador. Os objetos são enviados pelo pipeline para o Sort-Object cmdlet . 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 para Get-Member e verificar se os objetos são cadeias de caracteres em vez de inteiros. Para esses exemplos, o ProductId.txt arquivo contém uma lista não classificada de números de produto.

No primeiro exemplo, Get-Content obtém o conteúdo das linhas de arquivo e pipes para o Sort-Object cmdlet. Sort-Object classifica os objetos de cadeia de caracteres em ordem crescente.

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 | Sort-Object {[int]$_}
0
1
2
77
88
500
1500
2800
3500
4100
6200
12345
99999

No segundo exemplo, Get-Content obtém o conteúdo das linhas de arquivo e pipes para o Sort-Object cmdlet. Sort-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 Sort-Object cmdlet . Sort-Object classifica os objetos inteiros em ordem numérica.

Exemplo 9: Usando classificações estáveis

Quando você usa os parâmetros Superior, Inferior ou Estável , os objetos classificados são entregues na ordem em que foram recebidos quando Sort-Object os critérios de classificação são iguais. Neste exemplo, estamos classificando os números de um a 20 pelo valor 'modulo 3'. O valor do módulo varia de zero a dois.

PS> 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

PS> 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

A saída da primeira classificação é agrupada corretamente pelo valor de módulo, mas os itens individuais não são classificados dentro do intervalo de módulos. A segunda classificação usa a opção Estável para retornar uma classificação estável.

Parâmetros

-Bottom

Especifica o número de objetos a serem obtidos do final de uma matriz de objetos classificada. Isso resulta em uma classificação estável.

Esse parâmetro foi introduzido no PowerShell 6.0.

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

-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.

Type:	SwitchParameter
Position:	Named
Default value:	Case-insensitive
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

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

-Property

Especifica os nomes de propriedade que Sort-Object usam 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 para o tipo de objeto ou os próprios objetos.

Várias propriedades podem ser classificadas em ordem crescente, em ordem decrescente ou em 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 hajam mais propriedades especificadas ou grupos de objetos.

O valor do parâmetro Property 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:

expression - <string> ou <script block>
ascending Ou descending - <boolean>

Para obter mais informações, consulte about_Calculated_Properties.

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

-Stable

Os objetos classificados são entregues na ordem em que foram recebidos quando os critérios de classificação são iguais.

Esse parâmetro foi adicionado no PowerShell v6.2.0.

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

-Top

Especifica o número de objetos a serem obtidos desde o início de uma matriz de objetos classificada. Isso resulta em uma classificação estável.

Esse parâmetro foi introduzido no PowerShell 6.0.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 maiúsculas e minúsculas são consideradas as mesmas. Por exemplo, caractere e CARACTERE.

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

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 Sort-Object cmdlet classifica objetos com base nas propriedades especificadas no comando ou nas propriedades de classificação padrão para o tipo de objeto. As propriedades de classificação padrão são definidas usando o PropertySet nomeado DefaultKeyPropertySet em um types.ps1xml arquivo. Para obter mais informações, consulte about_Types.ps1xml.

Se um objeto não tiver uma das propriedades especificadas, o valor da propriedade desse objeto será interpretado por Sort-Object como Null e colocado no final da ordem de classificação.

Quando nenhuma propriedade de classificação está disponível, o PowerShell tenta comparar os próprios objetos. 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 classificará pelos valores de enumeração. Para serviços windows, Stopped tem um valor de 1 e Running tem um valor de 4. Parado é classificado antes de Executar devido aos valores enumerados. Para obter mais informações, consulte ServiceControllerStatus.

O desempenho do algoritmo de classificação é mais lento ao fazer uma classificação estável.

Compartilhar via

Sort-Object

Syntax

Description

Exemplos

Exemplo 1: Classificar o diretório atual por nome

Exemplo 2: Classificar o diretório atual por comprimento do arquivo

Exemplo 3: Classificar processos por uso de memória

Exemplo 4: Classificar objetos HistoryInfo por Id

Exemplo 5: usar uma tabela de hash para classificar propriedades em ordem crescente e decrescente

Exemplo 6: Classificar arquivos de texto por intervalo de tempo

Exemplo 7: Classificar nomes em um arquivo de texto

Exemplo 8: Classificar uma cadeia de caracteres como um inteiro

Exemplo 9: Usando classificações estáveis

Parâmetros

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

Entradas

Saídas

Observações

Recursos adicionais

Compartilhar via

Sort-Object

Syntax

Description

Exemplos

Exemplo 1: Classificar o diretório atual por nome

Exemplo 2: Classificar o diretório atual por comprimento do arquivo

Exemplo 3: Classificar processos por uso de memória

Exemplo 4: Classificar objetos HistoryInfo por Id

Exemplo 5: usar uma tabela de hash para classificar propriedades em ordem crescente e decrescente

Exemplo 6: Classificar arquivos de texto por intervalo de tempo

Exemplo 7: Classificar nomes em um arquivo de texto

Exemplo 8: Classificar uma cadeia de caracteres como um inteiro

Exemplo 9: Usando classificações estáveis

Parâmetros

-Bottom

-CaseSensitive

-Culture

-Descending

-InputObject

-Property

-Stable

-Top

-Unique

Entradas

Saídas

Observações

Links Relacionados

Recursos adicionais