Out-GridView

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>]

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 instalaciones server Core de Windows Server.

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

• Ocultar, mostrar y reordenar columnas: para ocultar, mostrar o reordenar 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. Haga clic de nuevo para alternar entre ascendente y descendente.
• Filtro rápido. Utilice el cuadro Filtro en la parte superior de la ventana para buscar el texto de la tabla. Puede buscar texto en una columna determinada, buscar literales y buscar varias palabras.
• Filtro de criterios. Utilice el menú desplegable Agregar criterios para crear reglas para filtrar los datos. Esto es muy útil para conjuntos de datos muy grandes, como registros de eventos.
• Copie y pegue. Para copiar filas de datos de Out-GridView, presione CTRL+C (copiar). Puede pegar los datos en cualquier programa de texto o hoja de cálculo.

Para obtener instrucciones sobre el uso de estas características, escriba Get-Help Out-GridView -Full y consulte Cómo utilizar las características de la ventana de vista de cuadrícula en la sección Notas.

PS C:\> Get-Process | Out-GridView

Este comando obtiene los procesos que se ejecutan en el equipo local y los envía a una ventana de vista de cuadrícula.

PS C:\> $P = Get-Process
PS C:\> $P | Out-GridView

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 usa el cmdlet Get-Process para obtener los procesos en el 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.

PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridView

Este comando muestra una tabla con formato en una ventana de vista de cuadrícula.

Usa el cmdlet Get-Process para obtener los procesos del equipo.

A continuación, usa un operador de canalización (|) para enviar los objetos de proceso al cmdlet Select-Object. El comando usa el parámetro Property de Select-Object para seleccionar las propiedades Name, WorkingSet y PeakWorkingSet que se mostrarán en la tabla.

Otro operador de canalización envía los objetos filtrados al cmdlet Sort-Object, que los ordena en orden descendente según el valor de la propiedad WorkingSet .

La parte final del comando usa un operador de canalización (|) para enviar la tabla con formato a Out-GridView.

Ahora puede usar las características de la vista de cuadrícula para buscar, ordenar y filtrar los datos.

PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridView

Este comando guarda su salida en una variable y la envía a Out-GridView.

El comando usa el cmdlet Get-ChildItem para obtener los archivos en el 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 la salida en la variable $A y el operador de canalización (|) para enviar la salida a Out-GridView.

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.

PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

Este comando muestra los procesos que se ejecutan en el equipo Server01 en una ventana de vista de cuadrícula.

El comando usa ogv, que es el alias integrado para el cmdlet Out-GridView , usa el parámetro Title para especificar el título de la ventana.

PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

En este ejemplo se muestra el formato correcto para enviar datos recopilados desde equipos remotos al cmdlet Out-GridView .

El comando usa el cmdlet Invoke-Command para ejecutar un comando Get-Culture en tres equipos remotos. Usa un operador de canalización para enviar los datos que se devuelven al cmdlet Out-GridView.

Tenga en cuenta que el bloque de script que contiene los comandos que se ejecutan de forma remota 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.

PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

Este comando 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.

El comando usa el parámetro passThru de de Out-GridView, que permite enviar varios elementos a la canalización. El parámetro PassThru es equivalente a usar el valor Multiple del parámetro OutputMode .

PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"

Este comando muestra cómo usar el parámetro wait de Out-GridView para crear un acceso directo de Windows a la ventana de Out-GridView. Sin el parámetro Wait de , Windows PowerShell se cerraría tan pronto como se abrió la ventana Out-GridView, lo que cerraría la ventana de Out-GridView .

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede enviar cualquier objeto a este cmdlet.

Out-GridView no devuelve ningún objeto.

• En Windows PowerShell 2.0, el cmdlet Out-GridView está instalado de forma predeterminada en versiones de cliente de Windows, pero es una característica opcional en las versiones de Servidor de Windows. En Windows PowerShell 3.0, se instala en todos los sistemas de forma predeterminada. Sin embargo, si desactiva o quita la característica ISE de Windows PowerShell, el cmdlet Out-GridView también se desactiva o se quita.

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

• No se puede dar formato a la salida del comando que se envía a Out-GridView , por ejemplo, mediante los cmdlets Format-Table o 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.

• Atajos de teclado para Out-GridView

  Mediante los siguientes métodos abreviados de teclado, puede realizar muchas tareas rápidamente.

  Utilice esta tecla:Para realizar esta acción:

  TAB Mueve el cursor del cuadro Filtro al menú Agregar criterios a la tabla y atrás.

  FLECHA ARRIBA Subir una fila. Se moverá a los encabezados de columna.

  FLECHA ABAJO Bajar una fila.

  FLECHA IZQUIERDA En la fila de encabezado de columna, mueva una columna a la izquierda.

  FLECHA DERECHA En la fila de encabezado de columna, mueva a la derecha una columna.

  TECLA DEL MENÚ CONTEXTUAL En la fila del encabezado de columna, se 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 utilizar las funciones de la ventana de vista de cuadrícula

  En los temas siguientes se explica cómo usar las características de la ventana que muestra Out-GridView .

  Cómo ocultar, mostrar y reordenar columnas

  Para ocultar o mostrar una columna:

Haga clic con el botón secundario en cualquier encabezado de columna y haga clic en Seleccionar columnas.

2. En el cuadro de diálogo Seleccionar columnas, utilice las teclas de flecha para mover las columnas entre los cuadros Columnas seleccionadas y Columnas disponibles. Solo las columnas del cuadro Columnas seleccionadas aparecen en la ventana de vista de cuadrícula.

Para reordenar las columnas:

• Arrastre y coloque la columna en la ubicación deseada.

• o-

Haga clic con el botón secundario en cualquier encabezado de columna y haga clic en Seleccionar columnas.

2. En el cuadro de diálogo Seleccionar columnas, utilice los botones Subir y 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 datos de tabla

• Para seleccionar una fila, haga clic en 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 texto o hoja de cálculo. 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. 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 las filas que incluyen todas las palabras (AND lógico).

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

• Buscar en columnas. Para buscar texto en una o varias columnas, use el formato siguiente:

<columna>:<> de texto [<de columna>:<texto>] ...

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

Nombre de pantalla:net

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

displayname:nombre de la red:net

• Desactive la búsqueda. Para volver a mostrar toda la tabla, haga clic en el botón X rojo en 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 establecidos. 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:

operador<>de columna <><>

Los criterios para diferentes propiedades están conectados por AND. Los criterios para 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 del 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, haga clic para seleccionar un operador diferente de 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, 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.