Bases del informe HTML

En primer lugar, entender que PowerShell no se limita a crear informes en HTML. Pero me gusta el HTML porque es flexible, puede ser enviado fácilmente a través de correo electrónico, y se ve mucho mejor que un simple informe de texto sin ningún formato. Pero antes de sumergirnos en esto, necesitamos aclarar un poco cómo funciona el HTML.

Una página HTML es sólo un archivo de texto sin formato, con algo parecido a esto:

 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" \
 2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 3 <html xmlns="http://www.w3.org/1999/xhtml">
 4 <head>
 5 <title>HTML TABLE</title>
 6 </head><body>
 7 <table>
 8 <colgroup><col/><col/><col/><col/><col/></colgroup>
 9 <tr><th>ComputerName</th><th>Drive</th><th>Free(GB)</th><\
10 th>Free(%)</th><th>Size(GB)</th></tr>
11 <tr><td>CLIENT</td><td>C:</td><td>49</td><td>82</td><td>6\
12 0</td></tr>
13 </table>
14 </body></html>

Cuando se interpreta por un navegador, este archivo se representa en la pantalla que aparece en la ventana del navegador. Lo mismo se aplica a los clientes de correo electrónico capaces de mostrar contenido HTML. Mientras que usted, como persona, puede poner obviamente cualquier cosa en el archivo, necesita seguir las reglas que los browsers esperan para obtener la salida deseada.

Una de esas reglas es que cada archivo debe contener uno y un solo documento HTML. Es todo el contenido entre la etiqueta <HTML> y la etiqueta </HTML> (los nombres de las etiquetas no distinguen entre mayúsculas y minúsculas, y es común verlas en minúsculas como en el ejemplo anterior). Menciono esto porque una de las cosas más comunes que veré a la gente hacer con PowerShell se parecerá a esto:

1 Get-WmiObject -class Win32_OperatingSystem | ConvertTo-HT\
2 ML | Out-File report.html
3 Get-WmiObject -class Win32_BIOS | ConvertTo-HTML | Out-Fi\
4 le report.html -append
5 Get-WmiObject -class Win32_Service | ConvertTo-HTML | Out\
6 -File report.html -append

“Aaarrrggh,” dice mi colon cada vez que veo eso. Básicamente, está diciendo a PowerShell que cree tres documentos HTML completos y los coloque en un solo archivo. Mientras que algunos navegadores (Internet Explorer, por ejemplo) entenderán eso e intentarán mostrar algo, es simplemente incorrecto hacer esto. Una vez que empiece generar esta clase de informes, descubrirá rápidamente que este enfoque es doloroso. No es culpa de PowerShell; Simplemente no está siguiendo las reglas. ¡Por eso esta guía!

Se dará cuenta que el HTML consiste en muchas otras etiquetas, como: <TABLE>, <TD>, <HEAD>, y otras más. La mayoría de estas forman parejas, lo que significa que vienen en una etiqueta de apertura como <TD> y una etiqueta de cierre como </TD>. La etiqueta <TD> representa una celda de tabla, y todo entre esas etiquetas se considera el contenido de esa celda.

La sección <HEAD> es importante. Lo que hay dentro no es normalmente visible en el navegador. En su lugar, el navegador se centra en lo que hay en la sección <BODY>. La sección <HEAD> proporciona metadatos adicionales, como el título de la página (lo se muestra en la barra de título o pestaña de la ventana del navegador, no en la página), las hojas de estilo o las secuencias de comandos que se adjuntan a la página, y cosas así. Vamos a hacer algunas cosas impresionantes con la sección <HEAD>, confíe en mí.

También notará que este HTML es bastante “limpio”, en contraposición, digamos, a la salida HTML de Microsoft Word. Este HTML no contiene información visual incrustada en él, como colores o fuentes. Eso es bueno, porque sigue las buenas prácticas de HTML de separar la información de formato de la estructura del documento. Será decepcionante al principio, porque sus páginas HTML parecerán algo aburridas. Pero vamos a mejorar eso, también.

Para ayudar a que la narrativa de este libro permanezca enfocada, voy a comenzar con un solo ejemplo. En ese ejemplo, vamos a recuperar varios bits de información acerca de una computadora remota y formatear todo en un bonito y dinámico informe HTML. Con suerte, podrá concentrarse en las técnicas que estoy mostrando, y adaptarlas a sus propias necesidades.

En mi ejemplo, quiero que el informe tenga cinco secciones, cada una con la siguiente información:

  • Información de la computadora
  • Versión del sistema operativo del equipo, número de compilación y versión del Service Pack.
  • Información de hardware: la cantidad de RAM instalada y el número de cores, junto con el fabricante y el modelo.
  • Una lista de todos los procesos que se ejecutan en la máquina.
  • Una lista de todos los servicios que están configurados para iniciarse automáticamente, pero que no se están ejecutando.
  • Información sobre todos los adaptadores de red físicos en el equipo. No direcciones IP, necesariamente - información de hardware como la dirección MAC

Soy consciente que esta información no es un conjunto universalmente interesante, pero estas secciones permitirán demostrar algunas técnicas específicas. Una vez más, espero que usted pueda adaptar esto a sus necesidades precisas.

Up next

Recopilación de la información