Select-Object

Sintaxe

Select-Object
      [-InputObject <PSObject>]
      [[-Property] <Object[]>]
      [-ExcludeProperty <String[]>]
      [-ExpandProperty <String>]
      [-Unique]
      [-CaseInsensitive]
      [-Last <Int32>]
      [-First <Int32>]
      [-Skip <Int32>]
      [-Wait]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [[-Property] <Object[]>]
      [-ExcludeProperty <String[]>]
      [-ExpandProperty <String>]
      [-Unique]
      [-CaseInsensitive]
      [-Skip <Int32>]
      [-SkipLast <Int32>]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [-Unique]
      [-CaseInsensitive]
      [-Wait]
      [-Index <Int32[]>]
      [<CommonParameters>]

Select-Object
      [-InputObject <PSObject>]
      [-Unique]
      [-CaseInsensitive]
      [-SkipIndex <Int32[]>]
      [<CommonParameters>]

Description

O Select-Object cmdlet seleciona propriedades especificadas de um objeto ou conjunto de objetos. Ele também pode selecionar objetos únicos, um número especificado de objetos, ou então objetos em uma posição especificada em uma matriz.

Para selecionar objetos de uma coleção, use os parâmetros First, Last, Unique, Skip e Index . Para selecionar as propriedades do objeto, use o parâmetro Propriedade . Quando você seleciona propriedades, Select-Object retorna novos objetos que têm apenas as propriedades especificadas.

A partir do Windows PowerShell 3.0, Select-Object inclui um recurso de otimização que impede que comandos criem e processem objetos que não são usados.

Quando você usa Select-Object com os parâmetros First ou Index em um pipeline de comando, o PowerShell interrompe o comando que gera os objetos assim que o número selecionado de objetos é atingido. Para desativar esse comportamento de otimização, use o parâmetro Wait .

Exemplos

Exemplo 1: Selecionar objetos por propriedade

Este exemplo cria objetos que têm as propriedades Name, ID e WS (conjunto de trabalho) de objetos de processo.

Get-Process | Select-Object -Property ProcessName, Id, WS

Exemplo 2: Selecionar objetos por propriedade e formatar os resultados

Este exemplo obtém informações sobre os módulos usados pelos processos no computador. Ele usa Get-Process cmdlet para obter o processo no computador.

Ele usa o Select-Object cmdlet para gerar uma matriz de [System.Diagnostics.ProcessModule] instâncias, conforme contido na propriedade Modules de cada System.Diagnostics.Process saída de instância por Get-Process.

O parâmetro Property do cmdlet seleciona os nomes dos Select-Object processos. Isso adiciona uma ProcessName NoteProperty a cada [System.Diagnostics.ProcessModule] instância e a preenche com o valor da propriedade ProcessName do processo atual.

Por fim, Format-List cmdlet é usado para exibir o nome e os módulos de cada processo em uma lista.

Get-Process Explorer |
    Select-Object -Property ProcessName -ExpandProperty Modules |
    Format-List

ProcessName       : explorer
ModuleName        : explorer.exe
FileName          : C:\WINDOWS\explorer.exe
BaseAddress       : 140697278152704
ModuleMemorySize  : 3919872
EntryPointAddress : 140697278841168
FileVersionInfo   : File:             C:\WINDOWS\explorer.exe
                    InternalName:     explorer
                    OriginalFilename: EXPLORER.EXE.MUI
                    FileVersion:      10.0.17134.1 (WinBuild.160101.0800)
                    FileDescription:  Windows Explorer
                    Product:          Microsoft Windows Operating System
                    ProductVersion:   10.0.17134.1
...

Exemplo 3: Selecionar processos usando mais memória

Este exemplo obtém os cinco processos que estão usando mais memória. O Get-Process cmdlet obtém os processos no computador. O Sort-Object cmdlet classifica os processos de acordo com o uso de memória (conjunto de trabalho) e seleciona Select-Object apenas os últimos cinco membros da matriz de objetos resultante.

O parâmetro Wait não é necessário em comandos que incluem o Sort-Object cmdlet porque Sort-Object processa todos os objetos e retorna uma coleção. A Select-Object otimização está disponível apenas para comandos que retornam objetos individualmente à medida que são processados.

Get-Process | Sort-Object -Property WS | Select-Object -Last 5

Handles  NPM(K)    PM(K)      WS(K) VS(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
2866     320       33432      45764   203   222.41   1292 svchost
577      17        23676      50516   265    50.58   4388 WINWORD
826      11        75448      76712   188    19.77   3780 Ps
1367     14        73152      88736   216    61.69    676 Ps
1612     44        66080      92780   380   900.59   6132 INFOPATH

Exemplo 4: Selecionar caracteres exclusivos de uma matriz

Este exemplo usa o parâmetro Unique de Select-Object para obter caracteres exclusivos de uma matriz de caracteres.

"a","b","c","a","A","a" | Select-Object -Unique

a
b
c
A

Exemplo 5: Usando '-Unique' com outros parâmetros

O parâmetro Unique filtra os valores depois que outros Select-Object parâmetros são aplicados. Por exemplo, se você usar o parâmetro First para selecionar o primeiro número de itens em uma matriz, Unique será aplicado apenas aos valores selecionados e não à matriz inteira.

"a","a","b","c" | Select-Object -First 2 -Unique

a

Neste exemplo, First seleciona "a","a" como os 2 primeiros itens na matriz. Unique é aplicado e "a","a" retorna a como o valor exclusivo.

Exemplo 6: Selecionar cadeias de caracteres exclusivas usando o parâmetro '-CaseInsensitive'

Este exemplo usa comparações que não diferenciam maiúsculas de minúsculas para obter cadeias de caracteres exclusivas de uma matriz de cadeias de caracteres.

"aa", "Aa", "Bb", "bb" | Select-Object -Unique -CaseInsensitive

aa
Bb

Exemplo 7: Selecionar eventos mais recentes e mais antigos no log de eventos

Este exemplo obtém o primeiro (mais recente) e o último (mais antigo) eventos no log de eventos do Windows PowerShell.

Get-WinEvent obtém todos os eventos no log do Windows PowerShell e os salva na $a variável. Em seguida, $a é canalizado para o Select-Object cmdlet. O Select-Object comando usa o parâmetro Index para selecionar eventos da matriz de eventos na $a variável. O índice do primeiro evento é 0. O índice do último evento é o número de itens em $a menos 1.

$a = Get-WinEvent -LogName "Windows PowerShell"
$a | Select-Object -Index 0, ($a.count - 1)

Exemplo 8: Selecionar todos, exceto o primeiro objeto

Este exemplo cria um novo PSSession em cada um dos computadores listados nos arquivos Servers.txt, exceto no primeiro.

Select-Object Seleciona todos, exceto o primeiro computador, em uma lista de nomes de computador. A lista resultante de computadores é definida como o valor do parâmetro ComputerName do New-PSSession cmdlet.

New-PSSession -ComputerName (Get-Content Servers.txt | Select-Object -Skip 1)

Exemplo 9: Renomeie arquivos e selecione vários para revisar

Este exemplo adiciona um sufixo "-ro" aos nomes base de arquivos de texto que têm o atributo somente leitura e, em seguida, exibe os cinco primeiros arquivos para que o usuário possa ver uma amostra do efeito.

Get-ChildItem usa o parâmetro dinâmico ReadOnly para obter arquivos somente leitura. Os arquivos resultantes são canalizados para o Rename-Item cmdlet, que renomeia o arquivo. Ele usa o parâmetro PassThru de Rename-Item para enviar os arquivos renomeados para o Select-Object cmdlet, que seleciona os 5 primeiros para exibição.

O parâmetro Wait de Select-Object impede que o PowerShell interrompa o Get-ChildItem cmdlet depois de obter os primeiros cinco arquivos de texto somente leitura. Sem este parâmetro, somente os primeiros cinco arquivos somente leitura devem ser renomeados.

Get-ChildItem *.txt -ReadOnly |
    Rename-Item -NewName {$_.BaseName + "-ro.txt"} -PassThru |
    Select-Object -First 5 -Wait

Exemplo 10: Mostrar as complexidades do parâmetro -ExpandProperty

Este exemplo mostra as complexidades do parâmetro ExpandProperty .

Observe que a saída gerada foi uma matriz de [System.Int32] instâncias. As instâncias estão em conformidade com as regras de formatação padrão da Exibição de Saída. Isso é verdadeiro para todas as propriedades expandidas . Se os objetos de saída tiverem um formato padrão específico, a propriedade expandida poderá não estar visível.

# Create a custom object to use for the Select-Object example.
$object = [pscustomobject]@{Name="CustomObject";Expand=@(1,2,3,4,5)}
# Use the ExpandProperty parameter to Expand the property.
$object | Select-Object -ExpandProperty Expand -Property Name

1
2
3
4
5

# The output did not contain the Name property, but it was added successfully.
# Use Get-Member to confirm the Name property was added and populated.
$object | Select-Object -ExpandProperty Expand -Property Name | Get-Member

TypeName: System.Int32

Name        MemberType   Definition
----        ----------   ----------
CompareTo   Method       int CompareTo(System.Object value), int CompareTo(int value), ...
Equals      Method       bool Equals(System.Object obj), bool Equals(int obj), bool IEq...
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
GetTypeCode Method       System.TypeCode GetTypeCode(), System.TypeCode IConvertible.Ge...
ToBoolean   Method       bool IConvertible.ToBoolean(System.IFormatProvider provider)
ToByte      Method       byte IConvertible.ToByte(System.IFormatProvider provider)
ToChar      Method       char IConvertible.ToChar(System.IFormatProvider provider)
ToDateTime  Method       datetime IConvertible.ToDateTime(System.IFormatProvider provider)
ToDecimal   Method       decimal IConvertible.ToDecimal(System.IFormatProvider provider)
ToDouble    Method       double IConvertible.ToDouble(System.IFormatProvider provider)
ToInt16     Method       int16 IConvertible.ToInt16(System.IFormatProvider provider)
ToInt32     Method       int IConvertible.ToInt32(System.IFormatProvider provider)
ToInt64     Method       long IConvertible.ToInt64(System.IFormatProvider provider)
ToSByte     Method       sbyte IConvertible.ToSByte(System.IFormatProvider provider)
ToSingle    Method       float IConvertible.ToSingle(System.IFormatProvider provider)
ToString    Method       string ToString(), string ToString(string format), string ToS...
ToType      Method       System.Object IConvertible.ToType(type conversionType, System...
ToUInt16    Method       uint16 IConvertible.ToUInt16(System.IFormatProvider provider)
ToUInt32    Method       uint32 IConvertible.ToUInt32(System.IFormatProvider provider)
ToUInt64    Method       uint64 IConvertible.ToUInt64(System.IFormatProvider provider)
Name        NoteProperty string Name=CustomObject

Exemplo 11: Criar propriedades personalizadas em objetos

O exemplo a seguir demonstra o uso Select-Object de uma propriedade personalizada a qualquer objeto. Quando você especifica um nome de propriedade que não existe, Select-Object cria essa propriedade como uma NoteProperty em cada objeto passado.

$customObject = 1 | Select-Object -Property MyCustomProperty
$customObject.MyCustomProperty = "New Custom Property"
$customObject

MyCustomProperty
----------------
New Custom Property

Exemplo 12: Criar propriedades calculadas para cada InputObject

Este exemplo demonstra o uso Select-Object de propriedades calculadas para adicionar à sua entrada. Passar um ScriptBlock para o parâmetro Property faz com que Select-Object você avalie a expressão em cada objeto passado e adicione os resultados à saída. Dentro do ScriptBlock, você pode usar a $_ variável para fazer referência ao objeto atual no pipeline.

Por padrão, Select-Object usa a cadeia de caracteres ScriptBlock como o nome da propriedade. Usando uma tabela de hash, você pode rotular a saída do seu ScriptBlock como uma propriedade personalizada adicionada a cada objeto. Você pode adicionar várias propriedades calculadas a cada objeto passado para Select-Object.

# Create a calculated property called $_.StartTime.DayOfWeek
Get-Process | Select-Object -Property ProcessName,{$_.StartTime.DayOfWeek}

ProcessName  $_.StartTime.DayOfWeek
----         ----------------------
alg                       Wednesday
ati2evxx                  Wednesday
ati2evxx                   Thursday
...

# Add a custom property to calculate the size in KiloBytes of each FileInfo
# object you pass in. Use the pipeline variable to divide each file's length by
# 1 KiloBytes
$size = @{label="Size(KB)";expression={$_.length/1KB}}
# Create an additional calculated property with the number of Days since the
# file was last accessed. You can also shorten the key names to be 'l', and 'e',
# or use Name instead of Label.
$days = @{l="Days";e={((Get-Date) - $_.LastAccessTime).Days}}
# You can also shorten the name of your label key to 'l' and your expression key
# to 'e'.
Get-ChildItem $PSHOME -File | Select-Object Name, $size, $days

Name                        Size(KB)        Days
----                        --------        ----
Certificate.format.ps1xml   12.5244140625   223
Diagnostics.Format.ps1xml   4.955078125     223
DotNetTypes.format.ps1xml   134.9833984375  223

Exemplo 13: Selecionar chaves de tabela de hash sem usar propriedades calculadas

A partir do PowerShell 6, Select-Object dá suporte à seleção das chaves de entrada da tabela de hash como propriedades. O exemplo a seguir seleciona as weight chaves e name em uma tabela de hash de entrada e exibe a saída.

@{ name = 'a' ; weight = 7 } | Select-Object -Property name, weight

name weight
---- ------
a         7

Exemplo 14: ExpandProperty altera o objeto original

Este exemplo demonstra o efeito colateral do uso do parâmetro ExpandProperty . Quando você usa ExpandProperty, Select-Object adiciona as propriedades selecionadas ao objeto original como membros NoteProperty.

PS> $object = [PSCustomObject]@{
    name = 'USA'
    children = [PSCustomObject]@{
        name = 'Southwest'
    }
}
PS> $object

name children
---- --------
USA  @{name=Southwest}

# Use the ExpandProperty parameter to expand the children property
PS> $object | Select-Object @{n="country"; e={$_.name}} -ExpandProperty children

name      country
----      -------
Southwest USA

# The original object has been altered
PS> $object

name children
---- --------
USA  @{name=Southwest; country=USA}

Como você pode ver, a propriedade country foi adicionada ao objeto children depois de usar o parâmetro ExpandProperty.

Exemplo 15: Criar um novo objeto com propriedades expandidas sem alterar o objeto de entrada

Você pode evitar o efeito colateral de usar o parâmetro ExpandProperty criando um novo objeto e copiando as propriedades do objeto de entrada.

PS> $object = [PSCustomObject]@{
    name = 'USA'
    children = [PSCustomObject]@{
        name = 'Southwest'
    }
}
PS> $object

name children
---- --------
USA  @{name=Southwest}

# Create a new object with selected properties
PS> $newobject = [PSCustomObject]@{
    country = $object.name
    children = $object.children
}

PS> $newobject

country children
------- --------
USA     @{name=Southwest}

# $object remains unchanged
PS> $object

name children
---- --------
USA  @{name=Southwest}

Parâmetros

-CaseInsensitive

-ExcludeProperty

-ExpandProperty

-First

-Index

-InputObject

-Last

-Property

-Skip

-SkipIndex

-SkipLast

-Unique

-Wait

Entradas

PSObject

Você pode canalizar objetos para esse cmdlet.

Saídas

PSObject

Esse cmdlet retorna os objetos de entrada apenas com as propriedades selecionadas.

Observações

O PowerShell inclui os seguintes aliases para Select-Object:

• Todas as plataformas:
  • select

O recurso de otimização está Select-Object disponível apenas para comandos que gravam objetos no pipeline à medida que são processados. Esse recurso não tem nenhum efeito em comandos que armazenam objetos processados em buffer e gravam-nos como uma coleção de comandos. Gravar objetos imediatamente é uma prática recomendada para design de cmdlets. Para obter mais informações, consulte Gravar registros únicos no pipeline em Diretrizes de desenvolvimento fortemente incentivadas.

Links Relacionados

• about_Calculated_Properties
• Group-Object
• Sort-Object
• Where-Object