Troubleshoot issues when you add a Hyper-V host in Virtual Machine Manager
This article describes how to troubleshoot issues that occur when you add a Hyper-V host in System Center 2012 Virtual Machine Manager (VMM) and later versions.
Note
Home users: This article is only intended for technical support agents and IT professionals. If you're looking for help with a problem, ask the Microsoft Community.
Original product version: Microsoft System Center 2012 R2 Virtual Machine Manager, System Center 2012 Virtual Machine Manager, System Center 2016 Virtual Machine Manager
Original KB number: 2742275
The following errors are typically logged in the VMM console when an Add virtual machine host job fails:
Error (421)
Agent installation failed on servername.contoso.com because of a WS-Management configuration error.Error (2912)
An internal error has occurred trying to contact an agent on the servername.contoso.com server.Error (2916)
VMM is unable to complete the request. The connection to the agent servername.contoso.com was lost.Error (2927)
A Hardware Management error has occurred trying to contact server servername.contoso.com.
To determine the cause of the issue, perform the following steps.
Step 1: Review the VMM agent installation log file
On the Hyper-V host, review the vmmAgent.msi_date_time.log file that's located in the %systemdrive%\ProgramData\VMMLogs
directory.
Note
This log file may not exist if the failure occurs early in the installation process.
Step 2: Check the current WinHTTP proxy configuration
If WinHTTP is configured to use a proxy server (netsh winhttp set proxy
), the attempts by VMM to communicate with managed servers through a fully qualified URL (for example, https://server.contoso.com:5986
may fail unless Bypass proxy server for local address is defined to exclude FQDN host addresses. In this situation, error 2916 is returned. By using <local> alone, you'll bypass all short-name hosts. VMM uses FDQN.
To check the current WinHTTP proxy configuration, run the netsh winhttp show proxy
command. Additionally, the bypass list must be updated to include the domain name for hosts that are being added. For example, *.contoso.com will bypass the proxy for all hosts that end with contoso.com.
Example command:
netsh winhttp set proxy proxy-server="http=myproxy.contoso.com:80" bypass-list="*.contoso.com"
Step 3: Verify that the ports used by VMM are not blocked by a firewall
By default, VMM uses the following ports to communicate with the Hyper-V host:
- TCP port 443
- TCP port 5985
- TCP port 5986
For more information about the ports that are used by VMM, see Ports and Protocols for VMM.
Step 4: Check for duplicate service principal names (SPNs)
Perform the steps in Error 2927 (0x8033809d): Unable to add a managed host in VMM 2012 to check for duplicate SPNs.
Step 5: Check for corrupted performance counters on the Hyper-V host
Check the Application log on the host to see if the following event is logged:
Log Name: Application
Source: Microsoft-Windows-LoadPerf
Event ID: 3012
Description:
The performance strings in the Performance registry value is corrupted when process Performance extension counter provider. The BaseIndex value from the Performance registry is the first DWORD in the Data section, LastCounter value is the second DWORD in the Data section, and LastHelp value is the third DWORD in the Data section.
If event ID 3012 is logged on the host machine, perform the steps in How to manually rebuild Performance Counters for Windows Server 2008 64bit or Windows Server 2008 R2 systems to rebuild the performance counters.
Step 6: Manually install the VMM agent on the Hyper-V host
If the Add-SCVMHost
cmdlet continues to fail, manually install the agent on the Hyper-V host by performing the steps in Installing a VMM Agent Locally.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for