Document your vSphere environment? Yes you can!

I heard from Ariel Sanchez that he needed something tested.  It was vDocumentation and him and Edgar Sanchez had something very cool.  I want to share it with you as I think it very handy.  It produces very nice reports on your vSphere environment.  Lets see how to get it working and produce some reports.

The home of this project is in this GitHub location. But all the info you need is right here in this article.

Install

  • Have PowerCLI installed – preferably 6.5.2, and be in PowerCLI and execute these commands:

Install-Module ImportExcel -scope CurrentUser

Install-Module vDocumentation -scope CurrentUser

  • If you have errors when executing those commands you can add -force at the end of the line.
  • If you have installed this cool stuff a few weeks ago you should do:

Update-Module vDocumentation

  • If you want to learn what version you have, you can use the following command:

Get-Module vDocumentation -ListAvailable | Format-List

  • If you want help on one of the commands you can get it.

get-help Get-ESXSpeculativeExecution -full

Execution

Now connect to your vCenter (Connect-VIserver -server vcName) and execute the following commands:

Get-ESXInventory -ExportExcel -folderpath c:\

Get-ESXIODevice -ExportExcel -folderpath c:\

Get-ESXNetworking -ExportExcel -folderpath c:\

Get-ESXStorage -ExportExcel -folderpath c:\

Get-ESXPatching -ExportExcel -folderpath c:\

Get-ESXSpeculativeExecution -ExportExcel -folderpath c:\

Storage red errors gone in version v2.4.3. Note that there may be some red errors on the Get-ESXStorage but I can tell you they  know and are working on it – confirmed that the red with the storage still occurs in my lab (still see the errors in up to and including 2.4.1).

Once the reports are done, and you look in the location where they are written too – by default – your current folder so for me c:\scripts or where you set on the command line.

Reports

Below is screenshots of each report.  But only the first part, with each one you could scroll down and right in Excel.  They are very detailed reports.

Inventory

IO Device

Network

Storage

Patching

ESXSpeculativeExecution

There you have it.  With very little work, and very little config, you end up with a number of very detailed Excel spreadsheets on your vSphere environment.  Very handy stuff and I sure like how easy it is to install and update!

Updates:

  • 4/28/18 – red storage errors gone in 2.4.3. I used PowerCLI 10.1.0 and all was good.
  • 3/25/18 – v2.41 and it works good. Some big changes – where are described in this article. My PowerShell can connect to the Internet so I did not have to download or import files. As well, I have not worked out some of the new parameters so have not updated my example commands above yet.
  • 2/4/18 – added new default location above.
  • 1/11/18 – and now another updated with more VMware checking for Speculative type stuff.  Nice job!
  • 1/9/18 – added in the GEt-ESXSpeculativeExecution option, and did some spell checking and added in the patching screen. Also added the comment about -folderpath.
  • 12/16/17 – added in the new Get-ESXPatching.  Still see the errors in red on storage in 2.0. I need to update the screenshots above, particularly Inventory, and add patching.  Will do it soon.
  • 10/18/17 – I did the Update-Module vDocumentation and there was an update.  Came down fine.  Here is the readme from GitHub. One thing I see I really like is that the default path is much easier and logical now – c:\users\your_user_name. I have also used this with PowerCLI 6.5.3 with no issue.  If your Get-Module shows you multiple vDocumentation, then use uninstall-module vDocumentation once for each installed version, then install again and you will only have the latest.  No matter how many versions you have installed, you will only execute the latest.

Michael

=== END ===

10 thoughts on “Document your vSphere environment? Yes you can!

    1. Hi Angelo,

      Thanks for reaching out. Yes, I do quite like RVtools and it is in my images. But I also like choices, and the script based ways to get documentation is pretty cool tool. I think it is very nice people like us have two ways to get reports!

      Michael

  1. The Storage report errors if there is no local storage in an ESX server. In our case booting from Dell Dual SD cards and all datastores are SAN based. Other than that thought, these are very cool

  2. Hi, I couldn’t retrieve patch info from hosts when i run this command:
    Get-ESXPatching : Could not find any baseline(s) named Critical Host Patches*,Non-Critical Host Patches* on server vCenter1.fqdn, vCenter2.fqdn. Please check Baseline name and try again. At line:1 char:1 + Get-ESXPatching -ExportExcel -folderpath h: + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,Get-ESXPatching

  3. Tried the latest v2.4.0, and running the Get-ESXSpeculativeExecuteion.ps1 with an input file (server is offline) I get an error – anyone seen (and fixed) this?

    Get-Date : Cannot bind parameter ‘Date’. Cannot convert value “10/25/2017” to type “System.DateTime”. Error: “String was not recognized as a valid DateTime.”
    At C:\Users\UserName\Documents\WindowsPowerShell\Modules\vDocumentation\2.4.0\Public\Get-ESXSpeculativeExecution.ps1:418 char:41
    + … = Get-Date (($vmhostview.Hardware.BiosInfo.ReleaseDate -split ” “)[0 …
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : InvalidArgument: (:) [Get-Date], ParameterBindingException
    + FullyQualifiedErrorId : CannotConvertArgumentNoMessage,Microsoft.PowerShell.Commands.GetDateCommand

    1. Hi Christopher,

      I have not seen this error. Seems like an odd one. You should try tweeting to the authors of the vDocumentation as they are pretty darn good guys and will likely be able to help more than me.

      Michael

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

w

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.