Convierte los objetos de Microsoft .NET Framework en un formato HTML que se pueda mostrar en un explorador web.

Sintaxis

ConvertTo-Html [[-Head] <string[]>] [[-Title] <string>] [[-Body] <string[]>] [-CssUri <Uri>] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]

ConvertTo-Html [-Fragment] [[-Property] <Object[]>] [-As <string>] [-InputObject <psobject>] [-PostContent <string[]>] [-PreContent <string[]>] [<CommonParameters>]

Descripción

El cmdlet ConvertTo-Html convierte los objetos de .NET Framework en un formato HTML que se pueda mostrar en un explorador web. Puede utilizar este cmdlet para mostrar el resultado de un comando en una página web.

Puede utilizar los parámetros de ConvertTo-Html para seleccionar propiedades de objeto, especificar un formato de tabla o de lista, especificar el título de la página HTML, agregar texto antes y después del objeto y devolver solo el fragmento de tabla o de lista en lugar de una página de DTD estricta.

Cuando se envían varios objetos a ConvertTo-Html, Windows PowerShell crea la tabla (o lista) basándose en las propiedades del primer objeto enviado. Si los objetos restantes no tienen una de las propiedades especificadas, el valor de propiedad de ese objeto es una celda vacía. Si los objetos restantes tienen propiedades adicionales, esos valores de propiedad no se incluyen en el archivo.

Parámetros

-As <string>

Determina si se aplica al objeto el formato de tabla o de lista. Los valores válidos son TABLE y LIST. El valor predeterminado es TABLE.

El valor TABLE genera una tabla HTML similar al formato de tabla de Windows PowerShell. La fila de encabezado muestra los nombres de propiedad. Cada fila de la tabla representa un objeto y muestra los valores del objeto para cada propiedad.

El valor LIST genera para cada objeto una tabla HTML de dos columnas que se parece al formato de lista de Windows PowerShell. En la primera columna se muestra el nombre de la propiedad y en la segunda columna se muestra el valor de la propiedad.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

Table

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Body <string[]>

Especifica el texto que se va a agregar después de la etiqueta de apertura <BODY>. De forma predeterminada, no hay texto en esa posición.

¿Requerido?

false

¿Posición?

4

Valor predeterminado

No text.

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-CssUri <Uri>

Especifica el identificador uniforme de recursos (URI) de la hoja de estilos en cascada (CSS) que se aplica al archivo HTML. En el resultado, el identificador URI se incluye en un vínculo de hoja de estilos.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Fragment

Genera solo una tabla HTML. Se omiten las etiquetas HTML, HEAD, TITLE y BODY.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Head <string[]>

Especifica el contenido de la etiqueta <HEAD>. El contenido predeterminado es "<title>HTML TABLE</title>". Si utiliza el parámetro Head, se omite el parámetro Title.

¿Requerido?

false

¿Posición?

2

Valor predeterminado

<title>HTML TABLE</title>

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-InputObject <psobject>

Especifica los objetos que se van a representar en HTML. Especifique la variable que contiene los objetos o escriba un comando o una expresión que los obtenga.

Si utiliza este parámetro para enviar varios objetos, como todos los servicios de un equipo, ConvertTo-Html crea una tabla en la que se muestran las propiedades de una colección o de una matriz de objetos (System.Object[]). Para crear una tabla de los objetos individuales, utilice el operador de canalización para canalizar los objetos a ConvertTo-Html.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-PostContent <string[]>

Especifica el texto que se va a agregar después de la etiqueta de cierre </TABLE>. De forma predeterminada, no hay texto en esa posición.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

No text

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-PreContent <string[]>

Especifica el texto que se va a agregar delante de la etiqueta de apertura <TABLE>. De forma predeterminada, no hay texto en esa posición.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

No text

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Property <Object[]>

Incluye las propiedades especificadas de los objetos en HTML.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Title <string>

Especifica un título para el archivo HTML, es decir, el texto que aparece entre las etiquetas <TITLE>.

¿Requerido?

false

¿Posición?

3

Valor predeterminado

¿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

Puede canalizar cualquier objeto de .NET a ConvertTo-Html.

Salidas

System.String

ConvertTo-Html devuelve una serie de cadenas que se componen de HTML válido.

Notas

Para utilizar este cmdlet, canalice uno o varios objetos al cmdlet o utilice el parámetro InputObject para especificar el objeto. Cuando la entrada se compone de varios objetos, el resultado de estos dos métodos difiere bastante.

-- Al canalizar varios objetos a un cmdlet, Windows PowerShell envía de uno en uno los objetos al cmdlet. Como resultado, ConvertTo-Html crea una tabla en la que se muestran los objetos individuales. Por ejemplo, si canaliza los procesos de un equipo a ConvertTo-Html, en la tabla resultante se muestran todos los procesos.

-- Cuando se utiliza el parámetro InputObject para enviar varios objetos, ConvertTo-Html recibe estos objetos como una colección o una matriz. Como resultado, crea una tabla en la que se muestran la matriz y sus propiedades en lugar de los elementos de la matriz. Por ejemplo, si utiliza InputObject para enviar los procesos de un equipo a ConvertTo-Html, en la tabla resultante se muestra una matriz de objetos (System.Object[]) y sus propiedades.

Para ajustarse a la DTD estricta de XHTML, la etiqueta DOCTYPE se modifica en consecuencia:

(<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">)

Ejemplo 1

C:\PS>convertto-html -inputobject (get-date)

Descripción
-----------
Este comando crea una página HTML en la que se muestran las propiedades de la fecha actual. Utiliza el parámetro InputObject para enviar los resultados de un comando Get-Date al cmdlet ConvertTo-Html.






Ejemplo 2

C:\PS>get-alias | convertto-html > aliases.htm

C:\PS> invoke-item aliases.htm

Descripción
-----------
Este comando crea una página HTML en la que se muestran los alias de Windows PowerShell en la consola actual.

El comando utiliza el cmdlet Get-Alias para obtener los alias. Utiliza el operador de canalización (|) para enviar los alias al cmdlet ConvertTo-Html, que crea la página HTML.






Ejemplo 3

C:\PS>get-eventlog -logname "Windows PowerShell | convertto-html > pslog.htm

Descripción
-----------
Este comando crea una página HTML denominada pslog.htm en la que se muestran los eventos incluidos en el registro de eventos de Windows PowerShell en el equipo local.

Utiliza el cmdlet Get-EventLog para obtener los eventos del registro de Windows PowerShell y, a continuación, utiliza el operador de canalización (|) para enviar los eventos al cmdlet ConvertTo-Html. 

El comando también utiliza el operador de redirección (>) para enviar el código HTML al archivo pslog.htm.






Ejemplo 4

C:\PS>get-process | convertto-html -property Name, Path, Company -title "Process Information" > proc.htm; ii proc.htm

Descripción
-----------
Estos comandos crean y abren una página HTML en la que se muestran el nombre, la ruta de acceso y la compañía de los procesos en el equipo local. 

El primer comando utiliza el cmdlet Get-Process para obtener los objetos que representan los procesos que se ejecutan en el equipo. El comando utiliza el operador de canalización (|) para enviar los objetos de proceso al cmdlet ConvertTo-Html. 

El comando utiliza el parámetro Property para seleccionar tres propiedades de los objetos de proceso que se van a incluir en la tabla. El comando utiliza el parámetro Title para especificar el título de la página HTML. También utiliza el operador de redirección (>) para enviar la página HTML resultante a un archivo denominado Proc.htm. 

El segundo comando usa el cmdlet Invoke-Item (alias = ii) para abrir el archivo Proc.htm en el explorador predeterminado. Los dos comandos están separados por un signo de punto y coma (;).






Ejemplo 5

C:\PS>get-service | convertto-html -CssUri "test.css"

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<title>HTML TABLE</title>
<link rel="stylesheet" type="text/css" href="test.css" />
...

Descripción
-----------
Este comando crea una página HTML de los objetos de servicio devueltos por el cmdlet Get-Service. El comando utiliza el parámetro CssUri para especificar una hoja de estilos en cascada para la página HTML. 

El parámetro CssUri agrega una etiqueta "<link rel="stylesheet" type="text/css" adicional a la página HTML resultante. El atributo HREF en la etiqueta contiene el nombre de la hoja de estilos.






Ejemplo 6

C:\PS>get-service | convertto-html -as LIST > services.htm

Descripción
-----------
Este comando crea una página HTML de los objetos de servicio devueltos por el cmdlet Get-Service. El comando utiliza el parámetro As para especificar un formato de lista. El operador de redirección (>) envía la página HTML resultante al archivo Services.htm.






Ejemplo 7

C:\PS>get-date | cth -fragment

<table>
<colgroup>...</colgroup>
<tr><th>DisplayHint</th><th>DateTime</th><th>Date</th><th>Day</th><th>DayOfWeek</th><th>DayOfYear</th><th>Hour</th><th>
Kind</th><th>Millisecond</th><th>Minute</th><th>Month</th><th>Second</th><th>Ticks</th><th>TimeOfDay</th><th>Year</th><
/tr>
<tr><td>DateTime</td><td>Monday, May 05, 2008 10:40:04 AM</td><td>5/5/2008 12:00:00 AM</td><td>5</td><td>Monday</td><td
>126</td><td>10</td><td>Local</td><td>123</td><td>40</td><td>5</td><td>4</td><td>633455808041237213</td><td>10:40:04.12
37213</td><td>2008</td></tr>
</table>

Descripción
-----------
Este comando utiliza ConvertTo-Html para generar una tabla HTML de la fecha actual. El comando utiliza el cmdlet Get-Date para obtener la fecha actual. Utiliza un operador de canalización (|) para enviar los resultados al cmdlet ConvertTo-Html (con el alias "cth"). 

El comando ConvertTo-Html incluye el parámetro Fragment, que limita el resultado a una tabla HTML. Como resultado, se omiten los otros elementos de una página HTML, como las etiquetas <HEAD> y <BODY>.






Ejemplo 8

C:\PS>get-eventlog -log "Windows PowerShell" | convertto-html -property id, level, task

Descripción
-----------
Este comando utiliza el cmdlet Get-EventLog para obtener los eventos del registro de eventos de "Windows PowerShell". 

Utiliza un operador de canalización (|) para enviar los eventos al cmdlet ConvertTo-Html, que los convierte en formato HTML. 

El comando ConvertTo-Html utiliza el parámetro Property para seleccionar solo las propiedades ID, Level y Task del evento.






Ejemplo 9

C:\PS>get-service A* | ConvertTo-Html -title "Windows Services: Server01" -body (get-date) -pre "<P>Generated by Corporate IT</P
>" -post "For details, contact Corporate IT." > services.htm; ii services.htm

Descripción
-----------
Este comando crea y abre una página web en la que se muestran los servicios del equipo que comienzan con "A". Utiliza los parámetros Title, Body, PreContent y PostContent de ConvertTo-Html para personalizar el resultado.

La primera parte del comando utiliza el cmdlet Get-Service para obtener los servicios del equipo que comienzan con "A". El comando utiliza un operador de canalización (|) para enviar los resultados al cmdlet ConvertTo-Html. El comando utiliza un operador de redirección (>) para enviar el resultado al archivo Services.htm. 

Un signo de punto y coma (;) finaliza el primer comando e inicia un segundo comando, que utiliza el cmdlet Invoke-Item (alias = "ii") para abrir el archivo Services.htm en el explorador predeterminado.






Vea también




Tabla de contenido