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. Required roles Users with the itil and asset roles can access Hyper-V configuration item (CI) records. To run discovery on Hyper-V servers, users must have the discovery_admin role. 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. Hyper-V architecture Table Purpose Hyper-V Server [cmdb_ci_hyper_v_server] Contains data about the physical machine running the Hyper-V server. This table has a reference relationship with the existing Windows Server [cmdb_ci_win_server] table. Hyper-V Virtual Machine Instance [cmdb_ci_hyper_v_instance] Contains data about Hyper-V instances. Hyper-V Virtual Network [cmdb_ci_hyper_v_network] Contains data about Hyper-V networks. Hyper-V Cluster [cmdb_ci_hyper_v_cluster] Contains data about Hyper-V clusters. This table has a reference relationship with the existing Windows Cluster [cmdb_ci_win_cluster] table. Hyper-V Resource Pool [cmdb_ci_hyper_v_resource_pool] Contains data about Hyper-V resource pools. Hyper-V Resource Pool Component [cmdb_ci_hyper_v_rpool_comp] Contains groups of Hyper-V resource pools. Hyper-V Object [cmdb_ci_hyper_v_object] Base class for all Hyper-V objects. The base system modifies these tables for use with multiple virtualization products: 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. Figure 1. Hyper-V Schema Diagram Hyper-V data collected by DiscoveryWhen Discovery detects the Hyper-V process running on a host machine, it launches exploration probes that return the typical Windows server data and the following data on the Hyper-V instances. Label Field Name Data Description Stored in Table State state On Off Suspended Changing Stuck cmdb_ci_vm_instance CPUs cpus Count cmdb_ci_vm_instance Memory memory Quantity in MB cmdb_ci_vm_instance Network adapters nics Count cmdb_ci_vm_instance Disks disks Count * cmdb_ci_vm_instance Disks size disks_size Capacity in GB * cmdb_ci_vm_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 * Discovery can only return this information if the virtual machine is running. 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 Label Field Name Data Description Stored in Table Name name Name of the virtual network cmdb_ci ID object_id Globally unique identifier (GUID) cmdb_ci_vm_object Label Field Name Data Description Stored in Table ID object_id Globally unique identifier (GUID) cmdb_ci_vm_object Capacity capacity Maximum amount of the appropriate allocation unit cmdb_ci_hyper_v_resource_pool Allocation units allocation_units Units of measurement used (for example, MB or GB) cmdb_ci_hyper_v_resource_pool Resource type resource_type Type of resource discovered (for example, memory, or hard drive space) cmdb_ci_hyper_v_resource_pool Label Field Name Data Description Stored in Table Reference Table Windows Cluster win_cluster Reference field displaying the Windows Cluster on which the Hyper-V cluster resides. cmdb_ci_hyper_v_cluster cmdb_ci_win_cluster Clone Hyper-V virtual machinesWhen importing (cloning) Hyper-V virtual machines, make sure each virtual machine has a unique ID. Discovery identifies virtual machines with duplicate IDs as the same machine.