Select-Object

Módulo:

Microsoft.PowerShell.Utility

Selecciona objetos o propiedades de objeto.

Sintaxis

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

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

Para seleccionar objetos de una colección, use los parámetros First, Last, Unique, Skip e 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 usa Select-Object con los parámetros First o Index en una canalización de comandos, PowerShell detiene el comando que genera los objetos en cuanto se alcanza el número seleccionado de objetos. Para desactivar este comportamiento de optimización, use el parámetro Wait .

Ejemplos

Ejemplo 1: Selección de objetos por propiedad

En este ejemplo se crean objetos que tienen las propiedades Name, ID y working set (WS) de los objetos de proceso.

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

Ejemplo 2: Seleccionar objetos por propiedad y dar formato a los resultados

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

Usa el Select-Object cmdlet para generar una matriz de [System.Diagnostics.ProcessModule] instancias como se incluye en la propiedad Modules de cada System.Diagnostics.Process instancia de salida por Get-Process.

El parámetro Property del Select-Object cmdlet selecciona los nombres de proceso. Esto agrega una ProcessName propiedad NoteProperty a cada [System.Diagnostics.ProcessModule] instancia y la rellena con el valor de la propiedad ProcessName del proceso actual.

Por último, Format-List el cmdlet se usa 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
...

Ejemplo 3: Selección de procesos con la mayor cantidad de memoria

En este ejemplo se obtienen los cinco procesos que usan la mayor parte de la memoria. El Get-Process cmdlet obtiene los procesos del equipo. El Sort-Object cmdlet ordena los procesos según el uso de memoria (conjunto de trabajo) y el Select-Object cmdlet 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 Sort-Object cmdlet porque Sort-Object procesa todos los objetos y, a continuación, devuelve una colección. La Select-Object optimización 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

Ejemplo 4: Selección de caracteres únicos de una matriz

En este ejemplo se 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
A

Ejemplo 5: Uso de "-Unique" con otros parámetros

El parámetro Unique filtra los valores después de aplicar otros Select-Object parámetros. Por ejemplo, si usa el parámetro First para seleccionar el primer número de elementos de una matriz, Unique solo se aplica a los valores seleccionados y no a toda la matriz.

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

a

En este ejemplo, First selecciona "a","a" como los primeros 2 elementos de la matriz. Unique se aplica a "a","a" y devuelve a como valor único.

Ejemplo 6: Selección de cadenas únicas mediante el parámetro "-CaseInsensitive"

En este ejemplo se usan comparaciones que no distinguen mayúsculas de minúsculas para obtener cadenas únicas de una matriz de cadenas.

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

aa
Bb

Ejemplo 7: Selección de eventos más recientes y más antiguos en el registro de eventos

En este ejemplo se obtienen los primeros eventos (más recientes) y los últimos (más antiguos) del registro de eventos de Windows PowerShell.

Get-WinEvent obtiene todos los eventos del registro de Windows PowerShell y los guarda en la $a variable . A continuación, $a se canaliza al Select-Object cmdlet . El Select-Object comando usa el parámetro Index para seleccionar eventos de la matriz de eventos de la $a 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-WinEvent -LogName "Windows PowerShell"
$a | Select-Object -Index 0, ($a.count - 1)

Ejemplo 8: Seleccionar todo, pero el primer objeto

En este ejemplo se crea una nueva PSSession en cada uno de los equipos enumerados en los archivos Servers.txt, excepto en el primero.

Select-Object selecciona todo menos el primer equipo de una lista de nombres de equipo. La lista resultante de equipos se establece como el valor del parámetro ComputerName del New-PSSession cmdlet .

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

Ejemplo 9: Cambiar el nombre de los archivos y seleccionar varios para revisar

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

Get-ChildItem usa el parámetro dinámico ReadOnly para obtener archivos de solo lectura. Los archivos resultantes se canalizan al Rename-Item cmdlet , que cambia el nombre del archivo. Usa el parámetro PassThru de Rename-Item para enviar los archivos cambiados al Select-Object cmdlet , que selecciona los primeros 5 para mostrar.

El parámetro Wait de Select-Object impide que PowerShell detenga el Get-ChildItem cmdlet después de obtener los cinco primeros archivos de texto de solo lectura. Sin este parámetro, solo se puede cambiar 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

Ejemplo 10: Mostrar los detalles del parámetro -ExpandProperty

En este ejemplo se muestran los detalles del parámetro ExpandProperty .

Tenga en cuenta que la salida generada era una matriz de [System.Int32] instancias. Las instancias se ajustan a las reglas de formato estándar de la vista de salida. Esto es cierto para las propiedades expandidas . 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), ...
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

Ejemplo 11: Crear propiedades personalizadas en objetos

En el ejemplo siguiente se muestra cómo usar Select-Object para agregar una propiedad personalizada a cualquier objeto . Cuando se especifica un nombre de propiedad que no existe, Select-Object crea esa propiedad como una Propiedad NoteProperty en cada objeto pasado.

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

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

Ejemplo 12: Crear propiedades calculadas para cada InputObject

En este ejemplo se muestra cómo usar Select-Object para agregar propiedades calculadas a la entrada. Pasar un ScriptBlock al parámetro Property hace que Select-Object evalúe la expresión en cada objeto pasado y agregue los resultados a la salida. Dentro de ScriptBlock, puede usar la $_ variable para hacer referencia al objeto actual de la canalización.

De forma predeterminada, Select-Object usa la cadena ScriptBlock como nombre de la propiedad . Con una tabla Hash, puede etiquetar la salida de 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

Ejemplo 13: Selección de claves hashtable sin usar propiedades calculadas

A partir de PowerShell 6, Select-Object admite la selección de las claves de entrada de tabla hash como propiedades. En el ejemplo siguiente se seleccionan las weight claves y name en una tabla hash de entrada y se muestra la salida.

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

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

Ejemplo 14: ExpandProperty modifica el objeto original

En este ejemplo se muestra el efecto secundario del uso del parámetro ExpandProperty . Al usar ExpandProperty, Select-Object agrega las propiedades seleccionadas al objeto original como miembros 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 puede ver, la propiedad country se agregó al objeto children después de usar el parámetro ExpandProperty .

Ejemplo 15: Crear un nuevo objeto con propiedades expandidas sin modificar el objeto de entrada

Puede evitar el efecto secundario de usar el parámetro ExpandProperty creando un nuevo objeto y copiando las propiedades del 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

De forma predeterminada, cuando se usa el parámetro Unique , el cmdlet usa comparaciones que distinguen mayúsculas de minúsculas. Cuando se usa este parámetro, el cmdlet usa comparaciones que no distinguen mayúsculas de minúsculas.

Este parámetro se agregó en PowerShell 7.4.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ExcludeProperty

Especifica las propiedades que este cmdlet excluye de la operación. Se permiten los caracteres comodín.

A partir de PowerShell 6, ya no es necesario incluir el parámetro Property para que ExcludeProperty funcione.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-ExpandProperty

Especifica una propiedad para seleccionarla e indica que se debe realizar un intento para expandir esa propiedad. Si la canalización de objetos de entrada no tiene la propiedad denominada, Select-Object devuelve un error.

• Si la propiedad especificada es una matriz, cada valor de la matriz se incluye en la salida.
• Si la propiedad especificada es un objeto , las propiedades de los objetos se expanden para cada InputObject.

En cualquier caso, el tipo de los objetos de salida coincide con el tipo de la propiedad expandida.

Nota:

Hay un efecto secundario al usar ExpandProperty. Select-Object agrega las propiedades seleccionadas al objeto original como miembros NoteProperty.

Si se especifica el parámetro Property , Select-Object intenta agregar cada propiedad seleccionada como NoteProperty a cada objeto generado.

Advertencia

Si recibe un error que indica que una propiedad no se puede procesar porque ya existe una propiedad con ese nombre, tenga en cuenta lo siguiente. Tenga en cuenta que cuando se usa ExpandProperty, Select-Object no se puede reemplazar una propiedad existente. Esto significa lo siguiente:

• Si el objeto expandido tiene una propiedad del mismo nombre, el comando devuelve un error.
• Si el objeto Selected tiene una propiedad del mismo nombre que la propiedad de un objeto Expandido , el comando devuelve un error.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-First

Especifica el número de objetos para seleccionar desde el principio de una matriz de objetos de entrada.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Index

Selecciona objetos de una matriz basándose en sus valores de índice. Escriba los índices en una lista separada por comas. Los índices de una matriz comienzan por 0, donde 0 representa el primer valor y (n-1) representa el último valor.

Tipo:	Int32[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica los objetos que se van a enviar al cmdlet a través de la canalización. Este parámetro permite canalizar objetos a Select-Object.

Cuando se pasan objetos al parámetro InputObject, en lugar de usar la canalización, Select-Object se trata InputObject como un solo objeto, incluso si el valor es una colección. Se recomienda usar la canalización al pasar colecciones a Select-Object.

Tipo:	PSObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Last

Especifica el número de objetos que se van a seleccionar desde el final de una matriz de objetos de entrada.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Property

Especifica las propiedades que se van a seleccionar. Estas propiedades se agregan como miembros NoteProperty a los objetos de salida. Se permiten los caracteres comodín. Si el objeto de entrada no tiene la propiedad denominada, el valor del nuevo NoteProperty se establece en $null.

El valor del parámetro Property puede ser una nueva propiedad calculada. Para crear una propiedad calculada, utilice una tabla hash.

Las claves válidas son:

• Nombre (o etiqueta): <string>
• Expresión: <string> o <script block>

Para obtener más información, consulte about_Calculated_Properties.

Tipo:	Object[]
Posición:	0
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-Skip

Omite (no selecciona) el número especificado de elementos. De forma predeterminada, el parámetro Skip cuenta desde el principio de la colección de objetos . Si el comando usa el parámetro Last , cuenta desde el final de la colección.

A diferencia del parámetro Index , que comienza a contar en 0, el parámetro Skip comienza en 1.

A partir de PowerShell 7.4, puede usar el parámetro Skip con el parámetro SkipLast para omitir elementos desde el principio y el final de la colección.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SkipIndex

Omite (no selecciona) los objetos de una matriz en función de sus valores de índice. Escriba los índices en una lista separada por comas. Los índices de una matriz comienzan por 0, donde 0 representa el primer valor y (n-1) representa el último valor.

Este parámetro se introdujo en Windows PowerShell 6.0.

Tipo:	Int32[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SkipLast

Omite (no selecciona) el número especificado de elementos desde el final de la lista o matriz. Funciona de la misma manera que usar Skip junto con el parámetro Last .

A diferencia del parámetro Index , que comienza a contar en 0, el parámetro SkipLast comienza en 1.

A partir de PowerShell 7.4, puede usar el parámetro Skip con el parámetro SkipLast para omitir elementos desde el principio y el final de la colección.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Unique

Especifica que si un subconjunto de los objetos de entrada tiene propiedades y valores idénticos, solo se debe seleccionar un único miembro del subconjunto.

Único selecciona los valores después de aplicar otros parámetros de filtrado.

Este parámetro distingue mayúsculas de minúsculas. Como resultado, las cadenas que solo difieren en las mayúsculas y minúsculas se consideran únicas. Agregue el parámetro CaseInsensitive para realizar comparaciones que no distinguen mayúsculas de minúsculas.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Wait

Indica que el cmdlet desactiva la optimización. PowerShell ejecuta comandos en el orden en que aparecen en la canalización de comandos y les permite generar todos los objetos. De forma predeterminada, si incluye un Select-Object comando con los parámetros First o 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.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

PSObject

Puede canalizar objetos a este cmdlet.

Salidas

PSObject

Este cmdlet devuelve los objetos de entrada con solo las propiedades seleccionadas.

Notas

PowerShell incluye los siguientes alias para Select-Object:

• Todas las plataformas:
  • select

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 sobre los comandos que almacenan en búfer los objetos procesados y los escriben como una colección. Durante el diseño de los cmdlets, se recomienda escribir los objetos inmediatamente. Para obtener más información, vea Escribir registros únicos en la canalización en Instrucciones de desarrollo muy recomendables.

Vínculos relacionados

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