vDocumentation - PowerCLI modul

Kb. három hónapja hallottam erről először, de miután megnéztem, úgy gondoltam, hogy nem olyan nagy durranás, hogy erről írni kelljen akár röviden is. De mivel ezt is elvileg a "közösség" fejleszti, ezért várhatóan sokat fog fejlődni az elkövetkezendő időben. Ezt vetíti előre az is, hogy már azóta is sokat változott, bővült a modul. Illetve mivel az idei VMworld-ön ennek külön előadást szenteltek, ezért is várható hogy a tartalom, funkcionalitás még jelentősen bővülni fog.
Tulajdonképen arra való, hogy egy egységes dokumentációs lehetőséget biztosítson az adminisztrátorok számára, egyelőre a hostok vonatkozásában.

Persze erre ott van az rvtools, de abba kód szinten nem tudunk belenézni, esetleg módosítani.

A terjesztés már úgy van megoldva mint a komplett PowerCLI csomag, azaz a Powershell Gallery-n keresztül.
Lekérdezhetjük,

Find-Module -name vDoc*

majd telepíthetjük a modult a szokásos módon:

Install-Module -Name vDocumentation  

Telepítés után ha megnézzük, hogy milyen új parancsok kerültek be a PowerShell rendszerünkben, akkor ezt kapjuk:

Get-Command -Module vDocumentation|select name,version 

Name              Version
----              -------
Get-ESXInventory  2.1.0  
Get-ESXIODevice   2.1.0  
Get-ESXNetworking 2.1.0  
Get-ESXPatching   2.1.0  
Get-ESXStorage    2.1.0  

A nevek alapján már mindenki következtetni tud a tartalomra.

Ami fontos kényelmi szolgáltatás, hogy az eredményeket közvetlenül Excel file-ba is megkaphatjuk még úgy is, ha nincs telepített Excel a gépünkön (ami persze manapság már elég ritkán fordul elő). Ehhez természetesen egy újabb modul szükséges, nevezetesen az ImportExcel modul, amit szintén a most már szokásos módon telepíthetünk, frissíthetünk.
Megjegyzendő az is, hogy host, cluster és datacenter szinten is futtathatjuk a scriptet, ilyenkor Excel-t megadva mint formátumot, hostonként egy sort kapunk.

Mint az elején már említettem, ettől sokkal összetettebb scriptek is vannak hasonló célra (a vCheck is idetartozik), de mint mindenből, ebből is lehet tanulni. Nem csak azt, hogy hogyan tudunk bizonyos értékeket lekérdezni, hanem azt is, hogy hogyan kell modul-t írni, és ez ami miatt én is elkezdtem ismerkedni vele.