Out-GridView

Módulo:

Microsoft.PowerShell.Utility

Envía la salida 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 cmdlet Out-GridView 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 usar 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 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 la 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 cmdlet Get-Process se guarda en la variable $P. 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 a Select-Object para seleccionar las propiedades Name, WorkingSety PeakWorkingSet. Otro operador de canalización envía los objetos filtrados al cmdlet para ordenarlos en orden descendente por el valor de la propiedad workingSet de . A continuación, los resultados ordenados se canalizan a Out-GridView. Ahora puede usar 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 variable automática $PSHOME. Los paréntesis del comando establecen el orden de las operaciones. Como resultado, la salida del comando Get-ChildItem se guarda en la variable $A 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 cmdlet Out-GridView. 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 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 comando Out-GridView. Si lo hiciera, se produciría un error en el comando 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 ventana Out-GridView. Los procesos que seleccione se pasan al comando Export-Csv y se escriben en el archivo ProcessLog.csv.

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

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

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

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

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 ventana , lo que cerraría casi inmediatamente la ventana de .

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 trata la colección como un objeto de colección y 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 ninguna salida. Para enviar elementos desde la ventana interactiva a la canalización, haga clic para seleccionar los elementos y, a continuación, haga clic en Aceptar.

Los valores de este parámetro determinan cuántos elementos puede enviar a la canalización.

• None. No hay elementos. Este es el valor predeterminado.
• Single. Cero elementos o un elemento. Use este valor cuando el siguiente comando solo pueda tomar un objeto de entrada.
• Multiple. Cero, uno o varios elementos. Use este valor cuando el siguiente comando pueda tomar varios objetos de entrada. Este valor es equivalente al parámetro Passthru.

Este parámetro se introdujo 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 ninguna salida. Este parámetro es equivalente al uso del valor Multiple del parámetro OutputMode.

Para enviar elementos desde la ventana interactiva a la canalización, haga clic para seleccionar los elementos y, a continuación, 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 ventana Out-GridView. 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 ventana de Out-GridView. De forma predeterminada, el símbolo del sistema devuelve cuando se abre la ventana Out-GridView.

Esta característica le permite usar los cmdlets de Out-GridView en los accesos directos de Windows. Cuando se usa en un acceso directo sin el parámetro Wait de , la 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 usar un comando remoto para abrir una ventana de vista de cuadrícula en otro equipo.

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

Es posible que la salida deserializada de los comandos remotos no tenga el formato correcto en la ventana de vista de cuadrícula.

métodos abreviados de teclado de paraOut-GridView

Use esta clave:	Para realizar esta acción:
pestaña	Mueve el cursor desde el cuadro filtro de 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 de	En la fila de encabezado de columna, muestra la opción Seleccionar columnas.
Escriba 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

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 aparecen las columnas de la cuadro Seleccionar columnas en la ventana de vista de cuadrícula.

Para reordenar 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 el Subir y Botones Bajar para reordenar las columnas. Las columnas de la parte superior de la lista aparecen a la izquierda de las columnas de la parte inferior de la lista en la ventana de vista de cuadrícula.

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 a descendente. El orden actual se indica mediante un triángulo en el encabezado de columna.

Cómo seleccionar de 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 presionado el MAYÚS tecla mientras hace clic en las filas o usa las teclas de dirección.
• Para seleccionar filas noconsecutivas, 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 texto o hoja de cálculo. No puede copiar columnas ni partes de filas y no puede copiar la fila de encabezado de columna.

búsqueda en la tabla (filtro rápido)

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

• 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-GridView muestra filas que incluyen todas las palabras (lógico AND).

• Busque frases literales. Para buscar frases que incluyan 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 varias columnas, use el formato siguiente:

  <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 el displayName de y columnas Nombre, en el cuadro Filtro de , 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 se determinan mediante las propiedades de los objetos mostrados en la ventana de vista de cuadrícula y los tipos de .NET Framework de esas propiedades.

Cada criterio tiene el formato siguiente:

<column> <operator> <value>

Los criterios de las distintas propiedades están conectados por AND. Los criterios de la misma propiedad están conectados por OR. No se pueden cambiar los conectores lógicos.

Los criterios solo afectan a la presentación. No elimina 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, haga clic de nuevo 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 que no es válido, aparece un icono X circular. Para quitarlo, cambie el valor.
• Para crear una instrucción OR O, 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