Hola a tod@s

Tomando como referencia la lista de Top 10 VMware Admin Tools en esta oportunidad vengo a mostrarles como utilizar la herramienta de vDiagram que dispone de la posición #6 de la lista de herramientas más utilizadas por los administradores de infraestructuras de VMware. En esencia este script de PowerShell captura y dibuja una infraestructura de VMware vSphere utilizando Microsoft Visio. Originalmente, esta herramienta fue creada por Alan Renouf @alanrenouf y actualmente el proyecto es mantenido por Tony Gonzalez @vDiagram_Tony .

Text

Para utilizar esta herramienta es necesario cumplir con los siguientes requisitos:

  1. PowerShell >= 5.1
  2. Módulos de PowerCLI (Install-Module -Name VMware.PowerCLI)
  3. Microsoft Visio 2013+

Una vez tengamos todos los requisitos procedemos a descargar el código de PowerShell para poder obtener nuestro diagrama. Para descargar el archivo accedemos al siguiente enlace:

https://github.com/Tony-SouthFLVMUG/vDiagram2.0

Text

Una vez descargamos el paquete procedemos a descomprimir el contenido.

PS C:\> Expand-Archive -LiteralPath .\vDiagram2.0-master.zip -DestinationPath .
PS C:\> ls vD*


    Directory: C:\Users\jocolon\Downloads


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         8/26/2021  11:15 AM                vDiagram2.0-master
-a----         7/21/2021   9:37 AM       12470234 vDiagram2.0-master.zip


PS C:\>

Nos movemos a la carpeta descomprimida y validamos el contenido con el comando ls o dir.

PS C:\> cd .\vDiagram2.0-master\
PS C:\vDiagram2.0-master> ls


    Directory: C:\vDiagram2.0-master


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         2/15/2021   5:29 PM                archived
-a----         2/15/2021   5:29 PM             66 .gitattributes
-a----         2/15/2021   5:29 PM           5771 README.md
-a----         2/15/2021   5:29 PM         109288 vDiagram.ico
-a----         2/15/2021   5:29 PM         673926 vDiagram_2.0.11.ps1
-a----         2/15/2021   5:29 PM         985128 vDiagram_2.0.11.vssx
-a----         2/15/2021   5:29 PM         116398 vDiagram_Scheduled_Task_2.0.11.ps1
-a----         2/15/2021   5:29 PM         254037 vDiagram_Standard.png


PS C:\vDiagram2.0-master>

Utilizamos el comando Unblock-File que nos permite poder ejecutar los archivos que han sido descargados desde el Internet.

PS C:\vDiagram2.0-master> Unblock-File .\vDiagram_2.0.11.ps1
PS C:\vDiagram2.0-master>

El próximo paso sería utilizar el comando $PSVersionTable para validar la versión de PowerShell instalada localmente. Repasando la sección de requisitos podemos ver que para utilizar la herramienta de vDiagram necesitamos tener una versión de PowerShell 5.1.x o mayor. En este ejemplo podemos ver que mi computadora tiene la versión 5.1.19041.1151.

PS C:\vDiagram2.0-master> $PSVersionTable

Name                           Value
----                           -----
PSVersion                      5.1.19041.1151
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.19041.1151
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1


PS C:\vDiagram2.0-master>

Adicionalmente, validamos que el módulo de PowerCLI esté instalado utilizando el comando Get-Module.

PS C:\vDiagram2.0-master> Get-Module -ListAvailable -Name 'VMware.PowerCLI' | Sort-Object -Property Version -Descending | Select-Object -First 1


    Directory: C:\Program Files\WindowsPowerShell\Modules


ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Manifest   12.3.0.... VMware.PowerCLI


PS C:\vDiagram2.0-master> 

Luego de validar todos los requisitos podemos ejecutar el script utilizando el archivo principal .\vDiagram_2.0.11.ps1″.

PS C:\vDiagram2.0-master> 

PS C:\vDiagram2.0-master> .\vDiagram_2.0.11.ps1
[08/24/2021 10:45:16] VMware PowerCLI Module(s) 12.3.0.17860403 11.5.0.14912921  found on this machine.

Una vez el programa, termine de ejecutar podemos ver en la pestaña de Prerequisites un resumen de todas las dependencias y su estado. En este ejemplo podemos ver que todas las dependencias se muestran en color verde que nos indica que están instaladas.

Text

Siguiendo los pasos según se muestra en la pestaña de Directions es necesario ingresar la dirección de IP/FQDN del vCenter y las credenciales con privilegios que permita conectarse y extraer la información.

Text

Une vez completada la información del vCenter procedemos a validar la conexión presionando el botón de Connect to vCenter. Como se puede apreciar en la siguiente imagen el botón cambia a color verde indicando que hubo una conexión exitosa al vCenter con las credenciales provistas.

Text

El próximo paso sería seleccionar la pestaña de Capture CSVs for Visio y especificar la carpeta donde se grabaran los reportes con la información temporera para generar el diagrama. En este ejemplo, utilice la carpeta <Desktop/Output>.

Text

Es importante mencionar que por cada valor seleccionado se generará un archivo con la información del respectivo elemento.

Text

Luego procedemos a presionar Collect CSV Data para iniciar el proceso de recopilación de los datos.

Text

Una vez finalizado el proceso de recopilación de los datos podemos seleccionar la pestaña de Draw Visio y configurar la opción de Select CSV Input Folder.

Text

Luego seleccionas la carpeta donde están los datos previamente recopilados. En mi ejemplo sería la carpeta <Desktop/Output> que utilice en la sección de Capture CSVs for Visio.

Text

Ahora es necesario validar que la información necesaria para generar el diagrama está disponible al oprimir el botón CSV Validation Complete.

Text

En este próximo paso es necesario especificar la carpeta donde se guardará el diagrama una vez generado. Para esto presionamos Select Visio Output Folder y seleccionamos la carpeta que se utilizara para este propósito. En este ejemplo se seleccionó <Desktop/Output>.

Text

En el área de Visio Output Folder podemos seleccionar las múltiples opciones disponibles para generar el diagrama. Luego de seleccionar la carpeta de Output podemos comenzar a generar el diagrama presionando el botón Draw Visio.

Text

En este paso del ejemplo presionamos OK en la notificación donde nos indica que el diagrama fue creado.

Text

Para ver el diagrama generado sobre nuestra infraestructura virtual presionamos el botón Open Visio Diagram.

Text

Finalmente, les dejo varias imágenes de ejemplo sobre los diagramas de mi infraestructura virtual HomeLab.

Text

Resumen

En este laboratorio utilizamos la herramienta llamada vDiagram que nos permite hacer una representación lógica de como está relacionado los componentes de nuestra infraestructura virtual. Algo bueno de esta herramienta es que está disponible de forma gratuita. Espero que este laboratorio les haya gustado. Si tienes dudas o alguna pregunta sobre este laboratorio, déjalo en los comentarios. ¡Hasta Luego!.