Out-GridView

Módulo:

Microsoft.PowerShell.Utility

Envía los resultados a una tabla interactiva en una ventana independiente.

Sintaxis

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Out-GridView cmdlet envía la salida de un comando a una ventana de vista de cuadrícula donde la salida se muestra en una tabla interactiva.

Dado que este cmdlet requiere una interfaz de usuario, no funciona en Windows Server Core o Windows Nano Server.

Puede utilizar las siguientes características de la tabla para examinar los datos:

• Ocultar, mostrar y reordenar columnas
• Ordenar filas
• Filtro rápido
• Agregar filtro de criterios
• Copiar y pegar

Para obtener instrucciones completas, consulte la sección Notas de este artículo.

Nota:

Este cmdlet se ha vuelto a introducir en PowerShell 7. Este cmdlet solo está disponible en sistemas Windows que admiten el escritorio de Windows. Para obtener una versión multiplataforma de este cmdlet, consulte el módulo ConsoleGuiTools en el Galería de PowerShell.

Ejemplos

Ejemplo 1: Procesos de salida en una vista de cuadrícula

En este ejemplo se obtienen los procesos que se ejecutan en el equipo local y se envían a una ventana de vista de cuadrícula.

Get-Process | Out-GridView

Ejemplo 2: Uso de una variable para generar procesos en una vista de cuadrícula

En este ejemplo también se obtienen los procesos que se ejecutan en el equipo local y se envían a una ventana de vista de cuadrícula.

$P = Get-Process
$P | Out-GridView

La salida del Get-Process cmdlet se guarda en la $P variable . A continuación, $P se canaliza a Out-GridView.

Ejemplo 3: Mostrar las propiedades seleccionadas en una vista de cuadrícula

En este ejemplo se muestran las propiedades seleccionadas de los procesos en ejecución en una vista de cuadrícula.

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

La salida de Get-Process se canaliza para Select-Object seleccionar las propiedades Name, WorkingSet y PeakWorkingSet . Otro operador de canalización envía los objetos filtrados al Sort-Object cmdlet para ordenarlos en orden descendente por el valor de la propiedad WorkingSet . A continuación, los resultados ordenados se canalizan a Out-GridView. Ahora puede utilizar las características de la vista de cuadrícula para buscar, ordenar y filtrar los datos.

Ejemplo 4: Guardar la salida en una variable y, a continuación, generar una vista de cuadrícula

En este ejemplo se guarda la salida del cmdlet en una variable y, a continuación, se envía a Out-GridView.

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem obtiene todos los archivos del directorio de instalación de PowerShell y sus subdirectorios mediante la $PSHOME variable automática. Los paréntesis en el comando establecen el orden de las operaciones. Como resultado, la salida del Get-ChildItem comando se guarda en la $A variable antes de enviarla a Out-GridView.

Ejemplo 5: Procesos de salida de un equipo especificado en una vista de cuadrícula

En este ejemplo se muestran los procesos que se ejecutan en el equipo Server01 en una ventana de vista de cuadrícula.

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

En el ejemplo se usa ogv, que es el alias del Out-GridView cmdlet . El parámetro Title especifica el título de la ventana.

Ejemplo 6: Salida de datos de equipos remotos a una vista de cuadrícula

En este ejemplo se muestra cómo enviar datos recopilados de equipos remotos a Out-GridView.

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command se ejecuta Get-Culture en tres equipos remotos. Los datos resultantes se canalizan a Out-GridView. Observe que el bloque de script que se ejecuta en el equipo remoto no incluye el Out-GridView comando . Si lo hiciera, el comando produciría un error al intentar abrir una ventana de vista de cuadrícula en cada uno de los equipos remotos.

Ejemplo 7: Pasar varios elementos a través de "Out-GridView"

Este ejemplo le permite seleccionar varios procesos en la Out-GridView ventana. Los procesos que seleccione se pasan al Export-Csv comando y se escriben en el ProcessLog.csv archivo.

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

El parámetro PassThru de Out-GridView le permite enviar varios elementos a la canalización. El parámetro PassThru equivale a usar el valor Multiple del parámetro OutputMode .

Ejemplo 8: Crear un acceso directo de Windows a "Out-GridView"

En este ejemplo se muestra cómo usar el parámetro Wait de Out-GridView para crear un acceso directo de Windows a la Out-GridView ventana.

pwsh -Command "Get-Service | Out-GridView -Wait"

Esta línea de comandos se puede usar en un acceso directo de Windows. Sin el parámetro Wait , PowerShell se cerraría tan pronto como se abrió la Out-GridView ventana, lo que cerraría casi inmediatamente la Out-GridView ventana.

Parámetros

-InputObject

Especifica el objeto que el cmdlet acepta como entrada para Out-GridView.

Cuando se usa el parámetro InputObject para enviar una colección de objetos a Out-GridView, Out-GridView se trata la colección como un objeto de colección y se muestra una fila que representa la colección. Para mostrar cada objeto de la colección, use un operador de canalización (|) para enviar objetos a Out-GridView.

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

-OutputMode

Especifica los elementos que la ventana interactiva envía a la canalización como entrada a otros comandos. De forma predeterminada, este cmdlet no genera ningún resultado. Para enviar elementos desde la ventana interactiva en sentido descendente por la canalización, haga clic para seleccionar los elementos y, después, haga clic en Aceptar.

Los valores de este parámetro determinan cuántos elementos puede enviar en sentido descendente por la canalización.

• None. Ningún elemento. Este es el valor predeterminado.
• Single. Ninguno o un elemento. Utilice este valor cuando el comando siguiente puede tomar solo un objeto de entrada.
• Multiple. Cero, uno o varios elementos. Utilice este valor cuando el comando siguiente pueda tomar varios objetos de entrada. Este valor es equivalente al parámetro PassThru .

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

Tipo:	OutputModeOption
Valores aceptados:	None, Single, Multiple
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Indica que el cmdlet envía elementos desde la ventana interactiva de la canalización como entrada a otros comandos. De forma predeterminada, este cmdlet no genera ningún resultado. Este parámetro es equivalente al uso del valor Multiple del parámetro OutputMode .

Para enviar elementos desde la ventana interactiva en sentido descendente por la canalización, haga clic para seleccionar los elementos y, después, haga clic en Aceptar. Se admiten Mayús+clic y Ctrl+clic.

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

-Title

Especifica el texto que aparece en la barra de título de la Out-GridView ventana. De forma predeterminada, la barra de título muestra el comando que invoca Out-GridView.

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

-Wait

Indica que el cmdlet suprime el símbolo del sistema e impide que Windows PowerShell se cierre hasta que se cierre la Out-GridView ventana. De forma predeterminada, el símbolo del sistema devuelve cuando se abre la Out-GridView ventana.

Esta característica le permite usar los Out-GridView cmdlets en los accesos directos de Windows. Cuando Out-GridView se usa en un acceso directo sin el parámetro Wait , la Out-GridView ventana solo aparece momentáneamente antes de que PowerShell se cierre.

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

Entradas

PSObject

Puede canalizar cualquier objeto a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

PSObject

Cuando se usa el parámetro PassThru , este cmdlet devuelve objetos que representan las filas seleccionadas.

Notas

PowerShell incluye los siguientes alias para Out-GridView:

• Windows:
  • ogv

Este cmdlet solo está disponible en plataformas Windows. Este cmdlet solo está disponible en plataformas Windows.

No puede utilizar un comando remoto para abrir una ventana de vista de cuadrícula en otro equipo.

La salida del comando a la que se envía Out-GridView no se puede dar formato mediante los Format cmdlets, como Format-Table los cmdlets o Format-Wide . Para seleccionar las propiedades, use el Select-Object cmdlet .

Puede que el resultado deserializado de los comandos remotos no tengan el formato correcto en la ventana de vista de cuadrícula.

Métodos abreviados de teclado para Out-GridView

Use esta clave:	Para realizar esta acción:
Tab	Mueve el cursor desde el cuadro Filtro al menú Agregar criterios a la tabla y atrás.
UpArrow	Subir una fila. Se mueve a los encabezados de columna de la primera fila de datos.
DownArrow	Bajar una fila.
LeftArrow	En la fila del encabezado de columna, mueva una columna a la izquierda.
RightArrow	En la fila de encabezado de columna, mueva a la derecha una columna.
ContextMenuKey	En la fila de encabezado de columna, muestra la opción Seleccionar columnas.
Entrar o barra espaciadora	En la fila de encabezado de columna, ordene los datos de columna (alternar A-Z, Z-A).

Cómo usar las características de la ventana Vista de cuadrícula

Para ocultar o mostrar una columna:

1. Haga clic con el botón derecho en cualquier encabezado de columna y haga clic en Seleccionar columnas.
2. En el cuadro de diálogo Seleccionar columnas , use las teclas de dirección para mover las columnas entre las columnas seleccionadas a los cuadros Columnas disponibles. Solo las columnas del cuadro Seleccionar columnas aparecen en la ventana de vista de cuadrícula.

Para reordenar las columnas:

Puede arrastrar y colocar columnas en la ubicación deseada. O bien, siga estos pasos:

1. Haga clic con el botón derecho en cualquier encabezado de columna y haga clic en Seleccionar columnas.
2. En el cuadro de diálogo Seleccionar columnas , use los botones Subir y Bajar para reordenar las columnas. En la ventana de vista de cuadrícula, las columnas de la parte superior de la lista aparecen a la izquierda de las columnas de la parte inferior de la lista.

Cómo ordenar datos de tabla

• Para ordenar los datos, haga clic en un encabezado de columna.
• Para cambiar el criterio de ordenación, vuelva a hacer clic en el encabezado de columna. Cada vez que haga clic en el mismo encabezado, el criterio de ordenación alterna entre orden ascendente y descendente. El orden actual se indica mediante un triángulo en el encabezado de columna.

Cómo seleccionar datos de tabla

• Para seleccionar una fila, seleccione la fila o use la flecha arriba o abajo para navegar a la fila.
• Para seleccionar todas las filas (excepto para la fila de encabezado), presione CTRL+A.
• Para seleccionar filas consecutivas, mantenga presionada la tecla MAYÚS mientras hace clic en las filas o usa las teclas de dirección.
• Para seleccionar filas no discretas, presione la tecla CTRL y haga clic para agregar una fila a la selección.
• No puede seleccionar columnas y no puede seleccionar toda la fila de encabezado de columna.

Cómo copiar filas

• Para copiar una o varias filas de la tabla, seleccione las filas y presione CTRL+C.

  Puede pegar los datos en cualquier programa de hoja de cálculo o de texto. No puede copiar columnas ni partes de filas y no puede copiar la fila de encabezado de columna.

Cómo buscar en la tabla (filtro rápido)

Use el cuadro Filtro para buscar datos en la tabla. Cuando se escribe en el cuadro, solo aparecen en la tabla los elementos que incluyen el texto escrito.

• Busque texto. Para buscar texto en la tabla, en el cuadro Filtro, escriba el texto que se va a buscar.

• Busque varias palabras. Para buscar varias palabras en la tabla, escriba las palabras separadas por espacios. Out-GridViewmuestra las filas que incluyen todas las palabras (AND lógico).

• Busque frases literales. Para buscar frases que contienen espacios o caracteres especiales, escriba la frase entre comillas. Out-GridView muestra filas que incluyen una coincidencia exacta para la frase.

• Buscar en columnas. Para buscar texto en una o más columnas, utilice el siguiente formato:

  <column>:<text> [<column>:<text>] ...

  Por ejemplo, para buscar "Net" en la columna DisplayName , en el cuadro Filtro , escriba:

  displayname:net

  Para buscar filas con "Net" en las columnas DisplayName y Name , en el cuadro Filtro , escriba:

  displayname:net name:net

• Desactive la búsqueda. Para volver a mostrar toda la tabla, haga clic en el botón X rojo de la esquina superior derecha del cuadro Filtro o elimine el texto del cuadro Filtro .

Usar criterios para filtrar la tabla

Puede usar reglas o criterios para determinar qué elementos se muestran en la tabla. Los elementos solo aparecen cuando cumplen todos los criterios que establezca. Los criterios disponibles dependen de las propiedades de los objetos mostrados en la ventana de vista de cuadrícula y de los tipos de .NET Framework de esas propiedades.

Cada criterio tiene el formato siguiente:

<column> <operator> <value>

Los criterios para diferentes propiedades están conectados por AND. Los criterios para la misma propiedad están conectados por OR. No puede cambiar los conectores lógicos.

Los criterios solo afectan a la presentación. No eliminan los elementos de la tabla.

Cómo agregar criterios

1. Para mostrar el botón de menú Agregar criterios , en la esquina superior derecha de la ventana, haga clic en la flecha Expandir.
2. Haga clic en el botón de menú Agregar criterios .
3. Haga clic para seleccionar columnas (propiedades). Puede seleccionar una o varias propiedades.
4. Cuando haya terminado de seleccionar propiedades, haga clic en el botón Agregar .
5. Para cancelar las adiciones, haga clic en Cancelar.
6. Para agregar más criterios, vuelva a hacer clic en el botón Agregar criterios .

Cómo editar un criterio

• Para cambiar un operador, haga clic en el valor del operador azul y, a continuación, seleccione otro operador en la lista desplegable.
• Para escribir o cambiar un valor, escriba un valor en el cuadro valor. Si escribe un valor no válido, aparece un icono X circular. Para quitarlo, cambie el valor.
• Para crear una instrucción OR , agregue un criterio con la misma propiedad.

Cómo eliminar criterios

• Para eliminar los criterios seleccionados, haga clic en la X roja junto a cada criterio.
• Para eliminar todos los criterios, haga clic en el botón Borrar todo .

Vínculos relacionados

• Out-File
• Out-Printer
• Out-String