大网数据广告活动
Hyper-V与虚拟化

Host Guardian Service Troubleshooting Guide

· 52CE 我爱测

Resolves issues that occur when you configure HGS to use HTTPS for key protection and attestation in test environments.

Summary

This article helps you to handle issues that occur when you configure the Host Guardian Service (HGS) to use HTTPS for key protection and attestation in test environments. By following these steps and guidelines, you can resolve configuration issues that affect the HGS, and ensure secure communication for your VMs.

Symptoms

The following symptoms occur when you try to enable HTTPS on the HGS:

  • Attestation and key unwrap operations for VMs fail.
  • TLS (Transport Layer Security) and certificate trust errors appear in browsers and clients.
  • The certificate's Subject Alternative Name (SAN) includes only the DNS HGS service name and not individual node hostnames.
  • You receive the following error message:

TransientError Host Unreachable

When this issue occurs, the following conditions apply:

  • Failures occur during attestation and key unwrap processes over HTTPS.
  • The configuration functions correctly when HTTP is used instead of HTTPS.
  • Network trace and Test-NetConnection confirm communication on required ports.
  • The certificate's Subject Alternative Name (SAN) includes only the DNS HGS service name and not individual node hostnames.
  • The issue isn't reproducible in other test environments, such as the support engineer's lab environment.

Cause

The root cause of the problem is related to the HTTPS configuration and certificate requirements for HGS:

  • Nonmandatory HTTPS: HTTPS is optional for HGS. HTTP communications are already encrypted at the message level as part of the Key Protection Service (KPS) protocol.
  • Certificate issues: The certificate that's used for HTTPS doesn't meet the documented requirements, such as missing SAN entries for all HGS node hostnames.
  • Environment-specific factors: The issue might be caused by configuration or compatibility challenges that are specific to the environment, or from deprecated features in the Windows Server version that's used.
  • Feature design: Development confirms that HGS over HTTP provides adequate encryption, and HTTPS isn't required for security.

Resolution

To resolve this issue, follow these steps:

  1. Use HTTP for HGS communication:

Based on recommendations from the product and development teams, you should continue to use HTTP for HGS. HTTP provides message-level encryption, ensuring data security.

  1. Validate encryption:

Collect network traces to verify that HTTP payloads are encrypted and not exposed in plain text.

  1. Certificate reconfiguration (if HTTPS is required):

If HTTPS must be used, make sure that certificates meet all documented requirements, including SAN entries for all HGS node hostnames. Consult the HGS documentation for guidance to issue certificates correctly.

  1. Use available tools for troubleshooting and validation:

Use the following tools and commands to troubleshoot and verify the configuration:

  • Test-NetConnection to verify required port connectivity
  • PowerShell cmdlets such as Set-HgsServer for configuring HGS
  • Network tracing tools to verify encryption of HTTP payloads
  • Browser-based validation to verify HTTPS endpoint and certificate trust
  1. Plan for future deployments:
  • Review feature deprecation notices for HGS and shielded VMs in newer Windows Server versions.
  • Consider alternatives, such as Azure Confidential Computing, for future deployments.
  1. Review documentation and guidelines:
  • Share relevant public documentation and internal guidelines with your team to ensure proper configuration and understanding of HGS.

Data collection

Before you contact Microsoft Support, you can gather the following information about your issue.

  • Network traces: Perform network tracing during key protection exchanges to verify encryption of communications.
  • PowerShell diagnostic outputs: Collect outputs from HGS servers and guarded hosts by using HGS-related PowerShell commands.
  • HTTP and HTTPS traffic logs: Analyze logs for TLS-related errors and communication issues.
  • Configuration details: Record details about the environment, such as certificate attributes, HGS node hostnames, and DNS configuration.

References

Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors (upstream author metadata: kaushika-msft). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / IT Pro troubleshooting
适用范围
- Supported versions of Windows Server · Source date 02/12/2026
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。