Added Invoke-VMToolsReport.ps1

Invoke-VMToolsReport.ps1

@@ -0,0 +1,122 @@
+<#
+.SYNOPSIS
+	vSphere guest OS & VMware Tools status report
+.DESCRIPTION
+	This function/script will query ALL guests in the environment and report on some basic guest OS details, as well as VMware Tools details.
+
+	You can either supply a vCenter Server name, or if you are already connected to one, or more, vCenter servers, it will automatically run against all currently connected servers.
+
+	Note: If you supply a vCenter Server name to connect to, the script will first DISCONNECT any currently connected session; this is to guarantee that the results returned are ONLY from the
+	server name provided, and not from any others.
+.PARAMETER Server
+	Name of vCenter server (VI Server)
+.INPUTS
+	System.String
+.OUTPUTS
+	System.Management.Automation.PSCustomObject
+.EXAMPLE
+	.\Invoke-VMwareToolsReport.ps1 -Server VCENTER01.corp.com -Verbose | Out-GridView
+.EXAMPLE
+	.\Invoke-VMwareToolsReport.ps1 -Verbose | Export-Csv C:\VMWareToolsReport.csv -NoTypeInformation
+.NOTES
+
+	#TAG:PUBLIC
+
+			GitHub: https://github.com/vScripter
+			Twitter: @vScripter
+			Email: [email protected]
+			Blog: www.vMotioned.com
+
+	[-------------------------------------DISCLAIMER-------------------------------------]
+	 All script are provided as-is with no implicit
+	 warranty or support. It's always considered a best practice
+	 to test scripts in a DEV/TEST environment, before running them
+	 in production. In other words, I will not be held accountable
+	 if one of my scripts is responsible for an RGE (Resume Generating Event).
+	 If you have questions or issues, please reach out/report them on
+	 my GitHub page. Thanks for your support!
+	[-------------------------------------DISCLAIMER-------------------------------------]
+
+.LINK
+	https://github.com/vScripter
+#>
+
+[CmdletBinding()]
+param (
+	[Parameter(Position = 0,
+			   Mandatory = $false,
+			   HelpMessage = 'Name of vCenter Server')]
+	[System.String]$Server
+)
+
+BEGIN {
+
+	Write-Verbose -Message 'Checking for VMware.VimAutomation.Core PSSnapin'
+	if ((Get-PSSnapin -Name VMware.VimAutomation.Core -ErrorAction 'SilentlyContinue').Name -eq $null) {
+		try {
+			Add-PSSnapin VMware.VimAutomation.Core -ErrorAction 'Stop'
+		} catch {
+			Write-Warning -Message "Error adding VMware PSSnapin: $_"
+			Write-Warning -Message 'Exiting script'
+			Exit
+		} # try/catch
+	} else {
+		Write-Verbose -Message "VMware.VimAutomation.Core PSSnapin is already added; continuing..."
+	} # end if/else
+
+	if ($Server) {		
+		Write-Verbose -Message 'Closing any current vCenter Server connections'
+		try {
+			Disconnect-VIServer -Server * -Confirm:$false -Force -ErrorAction 'Stop'
+		} catch {
+			Write-Warning -Message 'Error disconnecting current vCenter server connections; results may not be accurate or output may not be desired'
+		} # end try/catch
+
+		Write-Verbose -Message 'Connecting to vCenter Server'
+		try {			
+			$viServer = Connect-VIServer -Server $Server -ErrorAction 'Stop'
+		} catch {
+			Write-Warning -Message 'Error connecting to vCenter'
+			Write-Warning -Message 'Exiting script'
+			Exit
+		} # end try/catch
+
+	} elseif (($global:defaultviserver).Name -eq $null) {
+		Write-Warning -Message 'No default vCenter connection. Connect to vCenter or specify a vCenter Server name and try again.'
+		Write-Warning -Message 'Exiting script'
+		Exit
+	} # end if/else
+
+} # end BEGIN block
+
+PROCESS {
+
+	Write-Verbose -Message 'Gathering VM details'
+	foreach ($vis in ($global:defaultviservers).Name) {
+		$guestDetailQuery = $null
+		$guestDetailQuery = Get-View -Server $vis -ViewType VirtualMachine -ErrorAction 'Stop'
+
+		foreach ($guest in $guestDetailQuery) {
+			$objGuestDetail = @()
+			$objGuestDetail = [PSCustomObject] @{
+				Name = $guest.Name
+				HostName = $guest.Guest.HostName
+				IPAddress = $guest.Guest.IPAddress
+				GuestOS = $guest.Guest.GuestFullName
+				ToolsVersion = $guest.Guest.ToolsVersion
+				ToolsStatus = $guest.Guest.ToolsStatus
+				ToolsVersionStatus1 = $guest.Guest.ToolsVersionStatus
+				ToolsVersionStatus2 = $guest.Guest.ToolsVersionStatus2
+				ToolsRunningStatus = $guest.Guest.ToolsRunningStatus
+				VIServer = $vis
+			} # end $objGuestDetail
+
+			$objGuestDetail
+		} # end foreach $guest
+	} # end foreach $vis
+
+} # end PROCESS block
+
+END {
+
+} # end END block