We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Check manual page of hyperv_vms

Checkmk Manual

On this page

Search in the manual

Hyper-V Server: State of VMs

Distribution: official part of Check_MK
License: GPL
Supported Agents: Windows

This checks queries a Microsoft Hyper-V Server via an agent plugin (hyperv_vms.ps1) and checks the current state of the VM. The state is then mapped to a monitoring state. The default mapping is:

FastSaved => OK

FastSavedCritical => CRIT

FastSaving => OK

FastSavingCritical => CRIT

Off => WARN

OffCritical => CRIT

Other => UNKNOWN

Paused => OK

PausedCritical => CRIT

Pausing => OK

PausingCritical => CRIT

Reset => WARN

ResetCritical => CRIT

Resuming => OK

ResumingCritical => CRIT

Running => OK

RunningCritical => CRIT

Saved => OK

SavedCritical => CRIT

Saving => OK

SavingCritical => CRIT

Starting => OK

StartingCritical => CRIT

Stopping => WARN

StoppingCritical => CRIT

This mapping can be configured using the rule "State of Microsoft Hyper-V Server VMs".

Furthermore, the check can also be configured to compare the current state of the VM against the state at the point in time when the service was discovered. In this case, the service will go to CRIT if the two states do not match. Note that if the check is executed as a manual check, this option can still be used, however, the resulting monitoring state will always be UNKN in this case, since there is no discovered state available to compare against.


Name of the virtual machine


One service is created for each system.