InfrastructureUncategorizedVirtualization

VMM Resource Reporting

It can be difficult to monitor and assess resources in large Hyper-V environments. This Powershell based script helps you to understand virtualization inventory, capacity and general resource availability in your Standalone or Clustered Hyper-V Environment.

Highlights

  • Creates a plain but detailed and user-friendly HTML report which is compatible with all modern browsers.
  • Has an Overview section which shows momentary cluster resource usage.
  • Storage Overcommitment (see details below)
  • Shows alerts in the report for certain situations (utilizations, vm checkpoints, replication status, etc.)
  • Provides more detailed information via tooltips in the HTML report. (cells with asteriks and highlighted)
  • Includes a mode that reports only alerts in the Hyper-V environment. (aka HighlightsOnly mode)
  • Collects information by using standard Hyper-V and Clustering PowerShell cmdlets and custom WMI queries.
  • Checks and installs required runtime environment prerequisites like Hyper-V and Clustering Powershells.
  • Can be used directly from command-line or as a scheduled Windows task.
  • Supports report delivery via e-mail with advanced options. (authentication, TLS/SSL, multiple recipients)
  • Advanced error handling and logging. (Console messages and log file)

Version History and Change Log

  • [x] Version 1.5 – 05.March.2015

    o Added
    · Windows 8 and 8.1 OS support for script runtime environment
    · New Cluster Overview section
    · Storage Overcommitment
    · Supports for Extended Replica reporting
    · Hyper-V host information extended
    · VM Virtual Network information
    · $ReportFileNameTimeStamp parameter
    o Removed
    · $ReportIsBodyHTML parameter is no longer available

  • [x] Version 1.1 – 14.January.2015

    o Fixed
    · Rarely virtual machine cluster membership information is incorrect.
    · On standalone hyper-v hosts, volume information can not be reported correctly if there are physical hard drives which has the same serial number.
    o Added/Improved
    · Sending report as body of the e-mail. (using -ReportIsBodyHTML parameter)
    · Support for clustered pass-through disks that are assigned to VM.

  • [x] Version 1.0 (Release) – 06.January.2015
  • [x] Version 0.9 (Preview) – 26.December.2014
    *for a limited user group

Report Details

You can see an full example report: http://www.serhatakinci.com/files/get-hypervreport-demo.html

Cluster Overview (Applicable on clusters only)

o Physical Resources
· Node
· Processor
· Memory
· Storage

o Virtual Resources
· vMachine
· vProcessor
· vMemory
· vStorage

Hyper-V Host Table (Clustered or Standalone)

o Hostname
· Computer Manufacturer, Model
o Operating System Version
o State
o Uptime
o Domain Name
o Total and Running VM Count
· Detailed as Clustered and Non-clustered
o Processor Count
· Logical processor count
· Physical processor socket count
· Processor Manufacturer, Model, Ghz
· Hyper-Threading state for Intel processor (shown as tooltip)
· Virtual Processors per Logical Processor ratio
o Physical RAM capacity
· Used, Free, Total

Disk/Volume Table (Clustered or Local)

o Volume
· Name (Local Volume, Clustered Volume, Cluster Shared Volume)
· Label or CSV path (shown as tooltip)
· Disk name (Physical Disk, Clustered Disk)
· Total/Allocated/Unallocated physical disk size (shown as tooltip)

o Disk/Volume State
o Usage (Logical Partition, Cluster Volume, Cluster Shared Volume, Quorum, System Volume)
o Owner
o Physical Disk Bus Type
o Volume File System
o Active VHD (storage overcommitment)
o Disk and volume capacity
· Used, Free, Total

Virtual Machine Table

o Instance
· VM name
· Configuration XML path (shown as tooltip)
· Generation
· Version
o State
o Uptime
o Owner
o Virtual Processor
· Counts
o Virtual RAM
· Startup, Minimum, Maximum, Assigned
o Integration Services
· State like UpToDate, UpdateRequired, MayBeRequired, NotDetected
· Version number (shown as tooltip)
o Checkpoint
· Checkpoint state
· Checkpoint count (if exists, shown as tooltip)
· Checkpoint chain (if exists)
o Replica
· Replication State and Health
· Primary, Replica and Extended modes
· Replica Server or Primary Server (shown as tooltip)
· Replication Frequency (shown as tooltip)
· Last Replication Time (shown as tooltip)
o Disk
· VHD Name
· VHD File Path (shown as tooltip)
· Current VHD file size
· Maximum VHD disk size
· VHD Type
· Controller Type
· VHD fragmentation percent
· Including pass-trough disks (if exists)
· Including differencing virtual disk chain (if exists)
o Network Adapter
· Device type
· Connection status
· Virtual switch name
· IP address
· VLAN ID
· Advanced – MAC Address, MAC Type, DHCP Guard, Raouter Guard, Port Mirroring, Protected Network
o Can detects missing VHD files
o Can detects clustered VM configuration resource problems like offline
o Can detects clustered VM failed state

Requirements

Hyper-V Targets (Clustered or Standalone)

  • Active Directory domain membership
  • Supported Operating Systems
    • Windows Server 2012
    • Windows Server 2012 R2
    • Hyper-V Server 2012
    • Hyper-V Server 2012 R2

Script Runtime Operating System (directly on a Hyper-V target or remote Windows operating system)

  • Same or trusted Active Directory domain membership with Hyper-V target
  • Supported Operating Systems
    • Windows Server 2012
    • Windows Server 2012 R2
    • Windows 8
    • Windows 8.1
  • Windows PowerShell 3.0 or 4.0 (installed by default on supported server operating systems)
  • Sets the Windows PowerShell execution policy to RemoteSigned or Unrestricted
  • Hyper-V PowerShell (if not, automatically installed by the Get-HyperVReport.ps1 for server oses)
  • Failover Clustering PowerShell (if not, automatically installed by the Get-HyperVReport.ps1 for server oses)
  • The script requires administrative privileges on the target Hyper-V server(s)

Usage

1) Creates a Hyper-V Cluster report in the working directory.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1

2) Creates a Hyper-V Cluster report that shown only highlighted events and alerts in the working directory.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -HighlightsOnly $true

3) Creates one or more standalone Hyper-V Host(s) report in the working directory.

.\Get-HyperVReport.ps1 -VMHost Host1,Host2,Host3

4) Creates a Hyper-V Cluster report and sends it to multiple recipients as attachment without smtp authentication.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -SendMail $true -SMTPServer 10.29.0.50 -MailFrom sender@hyperv.com -MailTo recepient1@hyperv.com,recepient2@hyperv.com

5) Creates a Hyper-V Cluster report and sends it to multiple recipients as attachment with smtp authentication and TLS/SSL communication. -SMTPServerTLSorSSL is optional and used if forced by the smtp server.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -SendMail $true -SMTPServer smtp.mailserver.com -SMTPPort 587 -MailFrom sender@hyperv.com -MailFromPassword P@ssw0rd -SMTPServerTLSorSSL
$true -MailTo recepient1@hyperv.com,recepient2@hyperv.com

Leave a Reply

Your email address will not be published. Required fields are marked *