Envía el resultado a una tabla interactiva en una ventana independiente.
Sintaxis
Out-GridView [-InputObject <psobject>] [-Title <string>] [<CommonParameters>]
Descripción
El cmdlet Out-GridView envía el resultado de un comando a una ventana de vista de cuadrícula donde se muestra en una tabla interactiva. Esta característica requiere Microsoft .NET Framework 3.5 con Service Pack 1.
Para examinar los datos, se pueden usar las siguientes características de la tabla:
-- Ocultar, mostrar y reorganizar columnas. Para ocultar, mostrar o reorganizar una columna, haga clic con el botón secundario en un encabezado de columna y, a continuación, haga clic en "Seleccionar columnas".
-- Ordenar. Para ordenar los datos, haga clic en un encabezado de columna. Vuelva a hacer clic para cambiar de orden ascendente a descendente.
-- Filtro rápido. Use el cuadro "Filtro" situado en la parte superior de la ventana para buscar texto en la tabla. Puede realizar búsquedas de texto en una columna concreta, de literales y de varias palabras.
-- Filtro de criterios. Utilice el menú desplegable "Agregar criterios" para crear reglas a fin de filtrar los datos. Esto resulta muy útil para los conjuntos de datos de gran tamaño, como los registros de eventos.
-- Copiar y pegar. Para copiar filas de datos de Out-GridView, presione CTRL+C (copiar). Los datos se pueden pegar en cualquier editor de texto o programa de hoja de cálculo.
Para obtener instrucciones referentes al uso de estas características, escriba "Get-Help out-gridview -full" y vea "Cómo usar las características de la ventana de vista de cuadrícula" en la sección Notas.
Parámetros
-InputObject <psobject>
Acepta la entrada del cmdlet Out-GridView.
Cuando se usa el parámetro InputObject para enviar una colección de objetos (más de un objeto) a Out-GridView, Out-GridView trata la colección como un objeto de colección y muestra una sola fila que representa la colección. Para mostrar todos los objetos de la colección, use un operador de canalización (|) para enviar los objetos a Out-GridView.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Title <string>
Especifica el texto que aparece en la barra de título de la ventana Out-GridView.
De forma predeterminada, en la barra de título se muestra el comando que invoca Out-GridView.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
The current command |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.Management.Automation.PSObject Se puede enviar cualquier objeto a Out-GridView. |
|
Salidas |
Ninguno Out-GridView no devuelve ningún objeto. |
Notas
NOTAS REFERENTES A OUT-GRIDVIEW
----------------------
Microsoft .NET Framework 3.5 con Service Pack 1 está disponible en el Centro de descarga de Microsoft.
Dado que este cmdlet requiere una interfaz de usuario, no funciona en las instalaciones Server Core de Windows Server.
No se puede utilizar un comando remoto para abrir una ventana de vista de cuadrícula en un equipo remoto.
Al resultado del comando que se envía no se le puede aplicar un formato previo, por ejemplo, mediante el cmdlet Format-Table o Format-Wide. Para seleccionar propiedades, utilice el cmdlet Select-Object.
Los resultados deserializados de comandos remotos podrían no tener un formato correcto en la ventana de vista de cuadrícula.
MÉTODOS ABREVIADOS DE TECLADO PARA OUT-GRIDVIEW
-----------------------------------
Los siguientes métodos abreviados de teclado permiten realizar rápidamente un gran número de tareas.
Utilice esta tecla: Para realizar esta acción:
------------- ----------------------------------------------------------------
TAB Mover el cursor del cuadro Filtro al menú Agregar criterios y a la tabla, y viceversa.
FLECHA ARRIBA Subir una fila. El movimiento se realiza en dirección a los encabezados de columna.
FLECHA ABAJO Bajar una fila.
FLECHA IZQUIERDA En la fila de encabezado de columna, desplazarse una columna a la izquierda.
FLECHA DERECHA En la fila de encabezado de columna, desplazarse una columna a la derecha.
TECLA DE MENÚ CONTEXTUAL En la fila de encabezados de columna, mostrar la opción "Seleccionar columnas".
ENTRAR o BARRA ESPACIADORA En la fila de encabezado de columna, ordenar los datos de columna (cambiar de orden alfabético descendente a orden alfabético ascendente y viceversa).
CÓMO USAR LAS CARACTERÍSTICAS DE LA VENTANA DE VISTA DE CUADRÍCULA
----------------------------------------
En los temas siguientes, se explica cómo utilizar las características de la ventana que Out-GridView muestra.
Cómo ocultar, mostrar y reorganizar las columnas
--------------------------------------
Para ocultar o mostrar una columna:
1. Haga clic con el botón secundario en cualquier encabezado de columna y, a continuación, haga clic en "Seleccionar columnas".
2. En el cuadro de diálogo "Seleccionar columnas", use las teclas de dirección para mover las columnas del cuadro "Columnas seleccionadas" al cuadro "Columnas disponibles". Solo las columnas que figuran en el cuadro "Columnas seleccionadas" aparecen en la ventana de vista de cuadrícula.
Para reorganizar las columnas:
-- Arrastre y coloque la columna en la ubicación deseada.
o bien,
1. Haga clic con el botón secundario en cualquier encabezado de columna y, a continuación, haga clic en "Seleccionar columnas".
2. En el cuadro de diálogo "Seleccionar columnas", use los botones "Subir" y "Bajar" para reorganizar las columnas. Las columnas que figuran en la parte superior de la lista aparecen en la ventana de vista de cuadrícula a la izquierda de las columnas que figuran en la parte inferior de la lista.
Cómo ordenar los datos de la tabla
----------------------
-- Para ordenar los datos, haga clic en un encabezado de columna.
-- Para cambiar el orden, vuelva a hacer clic en el encabezado de columna. Cada vez que haga clic en el mismo encabezado, el orden cambiará de ascendente a descendente y viceversa. Un triángulo en el encabezado de columna indica el orden actual.
Cómo seleccionar datos de la tabla
------------------------
-- Para seleccionar una fila, haga clic en ella o utilice la flecha arriba o abajo para navegar hasta la fila.
-- Para seleccionar todas las filas (excepto la fila de encabezado), presione CTRL+A.
-- Para seleccionar filas consecutivas, mantenga presionada la tecla MAYÚS mientras hace clic en las filas o utiliza las teclas de dirección.
-- Para seleccionar filas no consecutivas, presione la tecla CTRL y haga clic en las filas que desee agregar a la selección.
No se pueden seleccionar columnas ni se puede seleccionar toda la fila de encabezados de columna.
Cómo copiar filas
----------------------
-- Para copiar una o varias filas de la tabla, seleccione las filas y, a continuación, presione CTRL+C.
Los datos se pueden pegar en cualquier editor de texto o programa de hoja de cálculo. No se pueden copiar columnas ni partes de filas, ni tampoco se puede copiar la fila de encabezado.
Cómo realizar búsquedas en la tabla (Filtro rápido)
---------------------------------
Utilice el cuadro "Filtro" para buscar datos en la tabla. Cuando escriba en el cuadro, solo aparecerán en la tabla los elementos que incluyan el texto escrito.
-- Buscar texto. Para buscar un texto en la tabla, en el cuadro "Filtro", escriba el texto que desee buscar.
-- Buscar varias palabras. Para buscar varias palabras en la tabla, escriba las palabras separadas por espacios. Out-GridView mostrará las filas que incluyan todas las palabras (operador AND lógico).
-- Buscar expresiones literales. Para buscar una expresión que incluya espacios o caracteres especiales, escríbala entre comillas. Out-GridView mostrará las filas que incluyan una coincidencia exacta de la expresión.
-- Buscar en columnas. Para buscar un texto en una o varias columnas, utilice el formato siguiente:
<columna>:<texto> [<columna>:<texto>] ...
Por ejemplo, para buscar "Net" en la columna DisplayName, en el cuadro "Filtro", escriba:
displayname:net
Para buscar las filas que incluyan "Net" en las columnas DisplayName y Name, en el cuadro "Filtro", escriba:
displayname:net name:net
-- Desactivar la búsqueda. Para volver a mostrar toda la tabla, haga clic en el botón X de color rojo situado en la esquina superior derecha del cuadro "Filtro" o elimine el texto de dicho cuadro.
Utilizar criterios para filtrar la tabla
--------------------------------
Puede utilizar reglas o "criterios" para determinar qué elementos se van a mostrar en la tabla. Los elementos aparecerán únicamente si cumplen todos los criterios que se hayan definido. Los criterios disponibles vienen determinados por las propiedades de los objetos que se muestran en la ventana de vista de cuadrícula y por los tipos de .NET Framework de dichas propiedades.
Cada criterio tiene el formato siguiente:
<columna> <operador> <valor>
Los criterios para propiedades diferentes se conectan mediante el operador AND. Los criterios para la misma propiedad se conectan mediante el operador OR. No se pueden cambiar los conectores lógicos.
Los criterios afectan únicamente a la presentación. No eliminan los elementos de la tabla.
Cómo agregar criterios
---------------------------
1. Para mostrar el botón del menú "Agregar criterios", en la esquina superior derecha de la ventana, haga clic en la flecha "Expandir".
2. Haga clic en el botón del menú "Agregar criterios".
3. Haga clic para seleccionar columnas (propiedades). Puede seleccionar una o varias propiedades.
4. Cuando termine 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 modificar un criterio
--------------------
-- Para cambiar un operador, haga clic en el valor de operador de color azul y, a continuación, haga clic en otro operador de la lista desplegable
para seleccionarlo.
-- Para escribir o cambiar un valor, escriba un valor en el cuadro de valor. Si escribe un valor no válido, aparecerá el icono circular X. Para quitarlo, cambie el valor.
-- Para crear una instrucción OR, agregue un criterio con la misma propiedad.
Cómo eliminar criterios
-------------------------
-- Para eliminar criterios seleccionados, haga clic en la X de color rojo situada junto a cada criterio.
-- Para eliminar todos los criterios, haga clic en el botón "Borrar todo".
Ejemplo 1
C:\PS>get-process | out-gridview Descripción ----------- Este comando obtiene los procesos que se ejecutan en el equipo local y los envía a una ventana de vista de cuadrícula.
Ejemplo 2
C:\PS>$p = get-process C:\PS> $p | out-gridview Descripción ----------- Este comando también obtiene los procesos que se ejecutan en el equipo local y los envía a una ventana de vista de cuadrícula. El primer comando utiliza el comando Get-Process para obtener los procesos del equipo y, a continuación, guarda los objetos de proceso en la variable $p. El segundo comando usa un operador de canalización para enviar la variable $p a Out-GridView.
Ejemplo 3
C:\PS>get-process | select-object -property name, workingset, peakworkingset | sort-object -property workingset -desc | out-gridview Descripción ----------- Este comando muestra una tabla con formato en una ventana de vista de cuadrícula. Utiliza el cmdlet Get-Process para obtener los procesos del equipo. A continuación, utiliza un operador de canalización (|) para enviar los objetos de proceso al cmdlet Select-Object. El comando utiliza el parámetro Property de Select-Object para seleccionar las propiedades Name, WorkingSet y PeakWorkingSet que se van a mostrar en la tabla. Otro operador de canalización envía los objetos filtrados al cmdlet Sort-Object, que los coloca en orden descendente según el valor de la propiedad WorkingSet. La última parte del comando utiliza un operador de canalización (|) para enviar la tabla con formato a Out-GridView. Ahora, puede utilizar las características de la vista de cuadrícula para ordenar, filtrar y buscar en los datos.
Ejemplo 4
C:\PS>($a = get-childitem -path $pshome -recurse) | out-gridview Descripción ----------- Este comando guarda su resultado en una variable y lo envía a Out-GridView. El comando utiliza el cmdlet Get-ChildItem para obtener los archivos del directorio de instalación de Windows PowerShell y sus subdirectorios. La ruta de acceso al directorio de instalación se guarda en la variable automática $pshome. El comando utiliza el operador de asignación (=) para guardar el resultado en la variable $a y usa el operador de canalización (|) para enviar el resultado a Out-GridView. Los paréntesis en el comando determinan el orden de las operaciones. Como consecuencia, el resultado del comando Get-ChildItem se guarda en la variable $a antes de que se envíe a Out-GridView.
Ejemplo 5
C:\PS>get-process -computername Server01| ogv -title "Processes - Server01" Descripción ----------- Este comando muestra en una ventana de vista de cuadrícula los procesos que se están ejecutando en el equipo Server01. El comando utiliza "ogv", que es el alias integrado del cmdlet Out-GridView, y utiliza el parámetro Title para especificar el título de la ventana.
Ejemplo 6
C:\PS>invoke-command -ComputerName S1, S2, S3 -scriptblock {get-culture} | out-gridview
Descripción
-----------
En este ejemplo, se muestra el formato correcto para enviar los datos recopilados en equipos remotos al cmdlet Out-GridView.
El comando usa el cmdlet Invoke-Command para ejecutar un comando Get-Culture en tres equipos remotos. Utiliza un operador de canalización para enviar los datos devueltos al cmdlet Out-GridView.
Observe que el bloque de script que contiene los comandos que se ejecutan de forma remota no incluye el comando Out-GridView. Si lo incluyera, el comando generaría un error al intentar abrir una ventana de vista de cuadrícula en cada uno de los equipos remotos.