Select-Object

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

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

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

El cmdlet Select-Object selecciona las propiedades especificadas de un objeto o conjunto de objetos. También puede seleccionar objetos únicos, un número especificado de objetos o objetos en una posición especificada en una matriz.

Para seleccionar objetos de una colección, use los parámetros First, Last, Unique, Skipy Index. Para seleccionar las propiedades del objeto, use el parámetro Property. Al seleccionar propiedades, Select-Object devuelve nuevos objetos que solo tienen las propiedades especificadas.

A partir de Windows PowerShell 3.0, Select-Object incluye una característica de optimización que impide que los comandos creen y procesen objetos que no se usan.

Cuando se incluye un comando Select-Object con el First o parámetros index en una canalización de comandos, PowerShell detiene el comando que genera los objetos en cuanto se genera el número seleccionado de objetos, incluso cuando el comando que genera los objetos aparece antes del comando Select-Object de la canalización. Para desactivar este comportamiento de optimización, use el parámetro wait .

Este comando crea objetos que tienen las propiedades Name, IDy working set (WS) de los objetos de proceso.

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

Este comando obtiene información sobre los módulos utilizados por los procesos del equipo. Usa Get-Process cmdlet para obtener el proceso en el equipo.

Usa el cmdlet para generar una matriz de instancias de tal y como se encuentra en la propiedad Modules de de cada salida de instancia de mediante .

El comando usa el parámetro Property del cmdlet para seleccionar los nombres de proceso. Esto agrega un ProcessNameNoteProperty a cada instancia de [System.Diagnostics.ProcessModule] y lo rellena con el valor de los procesos actuales propiedad ProcessName.

El comando usa el cmdlet Format-List para mostrar el nombre y los módulos de cada proceso de una 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
...

Este comando obtiene los cinco procesos que usan más memoria. El cmdlet Get-Process obtiene los procesos del equipo. El cmdlet Sort-Object ordena los procesos según el uso de memoria (conjunto de trabajo) y el cmdlet Select-Object selecciona solo los cinco últimos miembros de la matriz resultante de objetos.

El parámetro wait no es necesario en los comandos que incluyen el cmdlet porque procesa todos los objetos y, a continuación, devuelve una colección. La optimización Select-Object solo está disponible para los comandos que devuelven objetos individualmente a medida que se procesan.

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

Este comando usa el parámetro Unique de Select-Object para obtener caracteres únicos de una matriz de caracteres.

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

a
b
c

Estos comandos obtienen los primeros eventos (más recientes) y los últimos (más antiguos) del registro de eventos de Windows PowerShell.

El comando usa el cmdlet Get-EventLog para obtener todos los eventos en el registro de Windows PowerShell. Los guarda en la variable $a.

El segundo comando usa un operador de canalización (|) para enviar los eventos de $a al cmdlet Select-Object. El comando usa el parámetro index de para seleccionar eventos de la matriz de eventos de la variable . El índice del primer evento es 0. El índice del último evento es el número de elementos de $a menos 1.

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

Este comando crea una nueva PSSession en cada uno de los equipos enumerados en los archivos Servers.txt, excepto el primero.

Este comando usa el cmdlet Select-Object para seleccionar todo, pero el primer equipo de una lista de nombres de equipo. La lista resultante de equipos se establece como el valor del parámetro ComputerName de del cmdlet New-PSSession.

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

Este comando agrega un sufijo "-ro" a los nombres base de archivos de texto que tienen el atributo de solo lectura y, a continuación, muestra los cinco primeros archivos para que el usuario pueda ver un ejemplo del efecto.

El comando usa el readOnly parámetro dinámico del cmdlet Get-ChildItem for FileSystem para obtener archivos de solo lectura. Usa un operador de canalización (|) para enviar los archivos al cmdlet Rename-Item, que cambia el nombre del archivo. Usa el parámetro Passthru de Rename-Item para enviar los archivos cambiados al cmdlet Select-Object, que selecciona los primeros 5 para mostrar.

El parámetro wait de de impide que PowerShell detenga el cmdlet después de obtener los cinco primeros archivos de texto de solo lectura. Sin este parámetro, solo se cambiaría el nombre de los cinco primeros archivos de solo lectura.

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

En este ejemplo se muestran las complejidades del parámetro ExpandProperty.

Tenga en cuenta que la salida generada era una matriz de instancias de [System.Int32]. Las instancias se ajustan a las reglas de formato estándar de la vista de salida de . Esto es cierto para las propiedades de expandidas de . Si los objetos de salida tienen un formato estándar específico, es posible que la propiedad expandida no esté visible.

# 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), int IComparable.CompareTo(System.Object obj)...
Equals      Method       bool Equals(System.Object obj), bool Equals(int obj), bool IEquatable[int].Equals(int other)
GetHashCode Method       int GetHashCode()
GetType     Method       type GetType()
GetTypeCode Method       System.TypeCode GetTypeCode(), System.TypeCode IConvertible.GetTypeCode()
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 ToString(System.IFormatProvider provider)...
ToType      Method       System.Object IConvertible.ToType(type conversionType, System.IFormatProvider provider)
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

En el ejemplo siguiente se muestra el uso de Select-Object para agregar una propiedad personalizada a cualquier objeto. Al especificar un nombre de propiedad que no existe, Select-Object crea esa propiedad como NoteProperty en cada objeto pasado.

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

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

En este ejemplo se muestra el uso de Select-Object para agregar propiedades calculadas a la entrada. Pasar un scriptBlock de al parámetro Property hace que evalúen la expresión en cada objeto pasado y agreguen los resultados a la salida. En elscriptBlock de , puede usar la variable para hacer referencia al objeto actual de la canalización.

De forma predeterminada, Select-Object usará la cadena ScriptBlock como nombre de la propiedad. Con unhashtable de , puede etiquetar la salida de la ScriptBlock como una propiedad personalizada agregada a cada objeto. Puede agregar varias propiedades calculadas a cada objeto pasado a 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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede canalizar cualquier objeto a Select-Object.

• También puede hacer referencia al cmdlet Select-Object por su alias integrado, select. Para más información, vea about_Aliases.
• La característica de optimización de Select-Object solo está disponible para los comandos que escriben objetos en la canalización a medida que se procesan. No tiene ningún efecto en los comandos que almacena en búfer los objetos procesados y los escribe como una colección. Escribir objetos inmediatamente es un procedimiento recomendado de diseño de cmdlets. Para obtener más información, vea Escribir registros únicos en la canalización en Instrucciones de desarrollo fuertemente fomentadas en MSDN Library.