Recommended Agent: On-Premises
Supported Agents: On-Premises
Is Auto-Discovered By: Windows Server Inspector
Can Auto-Discover: N/A
Parent/Child Type Inspector: No
Inspection via: CLI
Data Summary: Here
Video isn't playing? Click here.
Run the following Powershell command in a powershell console window to check if you have the Hyper-V modules installed.
If the Hyper-V modules are not listed, then run the following command (note that if a restart is required then the command result will have "Restart Needed" set to "Yes".
Add-WindowsFeature -Name Hyper-V-PowerShell
Finally to test the module is installed and importable run the following command.
If you are running the Agent on a server that does not have Hyper-V manager installed, please note that PSRemoting is required to be enabled on the server running Hyper-V manager.
Username and Password are required if you are inspecting a server running Hyper-V manager which is not on the domain. The Username will likely need to be in the format: COMPUTERNAME\USERNAME
To enable PSRemoting use the following powershell command.
Hyper-V Host NOT tied to an Active Directory Domain
If you have a Hyper-V Host not tied to an Active Directory Domain, our best practice is to roll out an additional On-Premises Agent to the server that the Host is installed on. The additional Agent will auto-discover an Inspector for the local Windows server, and once activated, that Inspector will auto-discover a Hyper-V Inspector.
To roll out an additional On-Premises Agent, visit our Agent Documentation.
If you have activated your Windows Server Inspector(s), it will auto-discover your Hyper-V Inspectors. Follow the steps below:
Navigate to Admin > Inspectors > Select Hyper-V > Select the Discovered Systems tab
Here you can Activate your Discovered Hyper-V Inspector(s):
- Select the checkbox to the left of the Inspector(s) that you would like to Activate
- Select the Actions drop down menu above the Discovered Systems table
- Select Activate Launchpoints
In Liongard, navigate to Admin > Inspectors > Navigate to the Hyper-V Inspector > Select Add System.
Fill in the following information:
- Environment: Select the Environment this System Inspector should be associated to
- Friendly Name: Suggested "Hyper-V [Environment Name]"
- Agent: Select the On-premises Agent installed for this Environment
- Inspector Version: Latest
- Server Name: If running remotely, the fully qualified domain name of the server running Hyper-V manager
- MAC Address: This field is used when Hyper-v is auto-discovered to help provide a unique identifier. It is read-only.
- Username: If the server is not on the domain, the username used to log in to the server running Hyper-V manager
- Password: If required, the password for the user specified above to be able to login to the server running Hyper-V manager if the server is not on the domain.
- Scheduling: The Inspector will default to run once a day at the time the Inspector is set up. Here you can adjust the schedule
Select Save. The Inspector will now be triggered to run within the minute.
If you would like this Inspector's data to be sent to ConnectWise and/or IT Glue, turn on Flexible Assets/Configurations for this Inspector:
- ConnectWise: Admin > Integrations > ConnectWise > Configuration Types > Confirm the "Configuration Auto-Updating" toggle is enabled
- IT Glue: Admin > Integrations > IT Glue > Flexible Assets > Confirm the "Flexible Asset Auto-Updating" toggle is enabled
Often failures are a result of one of the issue listed below.
- Only Windows 2012/Windows 8 or better is supported.
- Unable to import the Hyper-V module, please verify the Hyper-V tools are installed on this system.
- Unable contact server, please verify the server Hostname is correct and network access is available.
- Unable establish a remote session with the server, please verify the server Hostname is correct and network access is available.
Updated 2 months ago