Hyper-V discovery

Microsoft Hyper-V is a virtualization application that is included with the Windows Server 2008 operating system.

About Hyper-V

A physical machine running Hyper-V is divided into partitions (virtual machines), including a parent partition running Windows Server 2008 and child partitions running supported guests. The parent partition manages the virtual machines with the Hyper-V Manager application. On Windows Server 2008 this is done through the Microsoft Management Console (MMC) service. On Windows 7, use the Remote Server Admin tools.

Hyper-V supports the following functionality:
  • Failover clustering: Failover is managed with Failover Cluster Manager.
  • Live migration: Virtual machines can be moved between failover cluster nodes without bringing down the virtual machine.

Supported versions

Discovery is supported for these Hyper-V Server versions:
  • 2008
  • 2012
  • 2012 R2 (Helsinki release only)

Support for discovery of Hyper V instances running on Windows 2016 is not supported.

Credentials

Configure Windows credentials with Domain administrator rights. You should also Enable PowerShell for the MID Server used to discover Hyper-V servers and instances.

Classifier, probes, and pattern

The Hyper-V Server classifier triggers probes that perform the discovery. Several probes are launched during discovery. See the classifier for a list of the trigger probes.

Note: The classification applies to stand-alone Hyper-V servers only (servers not running on Windows 2008).

Virtual Instances

Label Field Name Data Description Stored in Table
Object ID^ object_id ID cmdb_ci_hyper_v_instance
Name^ name name cmdb_ci_hyper_v_instance
State state
  • On
  • Off
  • Suspended
  • Changing
  • Stuck
cmdb_ci_hyper_v_instance*
CPUs cpus Count cmdb_ci_hyper_v_instance*
Memory memory Quantity in MB cmdb_ci_hyper_v_instance*
Network adapters nics Count cmdb_ci_hyper_v_instance*
Disks disks Count+ cmdb_ci_hyper_v_instance*
Disks size disks_size Capacity in GB+ cmdb_ci_hyper_v_instance*
Virtual Base Board Serial Number baseboard_serial Virtual serial number cmdb_ci_hyper_v_instance
BIOS Serial Number bios_serial Virtual serial number cmdb_ci_hyper_v_instance
Chassis Serial Number chassis_serial Virtual serial number cmdb_ci_hyper_v_instance
BIOS GUID bios_guid Globally unique identifier (GUID) cmdb_ci_hyper_v_instance

*Attributes that are put in the cmdb_ci_hyper_v_instance table when using the Hyper-V Server pattern. For upgrades to the Jakarta release, probes and sensors continue to put these attributes in the cmdb_ci_vm_instance table.

^Newly discovered attribute when using the Hyper-V Server pattern.

+Discovery can only return this information if the virtual machine is running.

Virtual servers

Label Field Stored in table
Name name cmdb_ci_hyper_v_server
Chassis type chassis_type cmdb_ci_hyper_v_server
Short description short_description cmdb_ci_hyper_v_server
OS Address Width (bits) os_address_width cmdb_ci_hyper_v_server
Operating System os cmdb_ci_hyper_v_server
Host name hostname cmdb_ci_hyper_v_server
IP Address ip_address cmdb_ci_hyper_v_server
OS Version os_version cmdb_ci_hyper_v_server
OS Service Pack os_service_pack cmdb_ci_hyper_v_server
Is virtual virtual cmdb_ci_hyper_v_server

Virtual Networks

Label Field Name Data Description Stored in Table
Name name Name of the virtual network cmdb_ci_hyper_v_network*
ID object_id Globally unique identifier (GUID) cmdb_ci_hyper_v_network*

*Attributes that are put in the cmdb_ci_hyper_v_network table when using the Hyper-V Server pattern. For upgrades to the Jakarta release, probes and sensors continue to put these attributes in the cmdb_ci table (name) and the cmdb_ci_vm_object table (object_id).

Resource Pools

Label Field Name Data Description Stored in Table
Name^ name Name of the resource pool. cmdb_ci_hyper_v_resource_pool
ID object_id Globally unique identifier (GUID) cmdb_ci_hyper_v_rpool_comp
Capacity capacity Maximum amount of the appropriate allocation unit cmdb_ci_hyper_v_rpool_comp
Allocation units allocation_units Units of measurement used (for example, MB or GB) cmdb_ci_hyper_v_rpool_comp
Resource type resource_type Type of resource discovered (for example, memory, or hard drive space) cmdb_ci_hyper_v_rpool_comp

Clusters

Label Field Name Data Description Stored in Table Reference Table
Windows Cluster name Reference field displaying the Windows Cluster on which the Hyper-V cluster resides. cmdb_ci_hyper_v_cluster cmdb_ci_win_cluster

Relationships

Discovery creates records in the CMDB for the host machine, the parent partition running Windows Server 2008, and all the virtual machines running on the Hyper-V server. Discovery finds the stored templates and maps all the relationships between components.

Table Purpose

Virtualization Server [cmdb_ci_virtualization_server]

Contains data on all discovered virtualization servers.

Virtual Machine Instance [cmdb_ci_vm_instance]

Contains data on all discovered virtual machine instances.

Virtual Machine Object [cmdb_ci_vm_object]

Contains data about various objects associated with a Hyper-V server, such as partitions, networks, resource pools, and clusters.

Parent table Relationship Child table
Hyper-V Virtual Machine Instance [cmdb_ci_hyper_v_instance] Registered on::Has registered Hyper-V Server [cmdb_ci_hyper_v_server]
Hyper-V Virtual Machine Instance [cmdb_ci_hyper_v_instance] Connected by ::Connects Hyper-V Network [cmdb_ci_hyper_v_network]
Hyper-V Network [cmdb_ci_hyper_v_network] Provided::Provides Hyper-V Server [cmdb_ci_hyper_v_server]
Hyper-V Resource Pool [cmdb_ci_hyper_v_resource_pool] Defines resources for:Gets resources from Hyper-V Server [cmdb_ci_hyper_v_server]
Hyper-V Resource Pool Components [cmdb_ci_hyper_v_rpool_comp] Contained by::Contains Hyper-V Resource Pool [cmdb_ci_hyper_v_resource_pool]
Hyper-V Cluster [cmdb_ci_hyper_v_cluster] Members::Member of Hyper-V Server [cmdb_ci_hyper_v_server]
Hyper-V Server [cmdb_ci_hyper_v_server] Runs on::Runs Windows Servers [cmdb_ci_win_server]
Windows Servers [cmdb_ci_win_server] Instantiates::Instantiated by Hyper-V Virtual Machine Instance [cmdb_ci_hyper_v_instance]
Windows Servers [cmdb_ci_win_server] Virtualized by::Virtualizes Hyper-V Server [cmdb_ci_hyper_v_server]