Out-GridView
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
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 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
Ejemplo 8: Crear un acceso directo de Windows a "Out-GridView"
En este ejemplo se muestra cómo usar el parámetro wait
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
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ámetroPassthru.
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
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Puede canalizar cualquier objeto a este cmdlet.
Salidas
None
De forma predeterminada, este cmdlet no devuelve ninguna salida.
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 |
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:
- Haga clic con el botón derecho en cualquier encabezado de columna y haga clic en Seleccionar columnas.
- 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:
- Haga clic con el botón derecho en cualquier encabezado de columna y haga clic en Seleccionar columnas.
- En el cuadro de diálogo Seleccionar columnas
, use el Subir yBotones 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
- Para mostrar el botón de menú Agregar criterios, en la esquina superior derecha de la ventana, haga clic en la flecha Expandir.
- Haga clic en el botón de menú Agregar criterios
. - Haga clic para seleccionar columnas (propiedades). Puede seleccionar una o varias propiedades.
- Cuando haya terminado de seleccionar propiedades, haga clic en el botón Agregar
. - Para cancelar las adiciones, haga clic en Cancelar.
- 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
.