适用于: Windows Server 2019、Windows Server (半年频道) 、Windows Server 2016
本主题介绍如何使用受保护的结构诊断工具来确定和修正受保护的结构基础结构的部署、配置和日常操作中的常见故障。 这包括主机保护者服务 (HGS) 、所有受保护的主机以及 DNS 和 Active Directory 等服务。 诊断工具可用于执行对失败的受保护结构的会审中的第一步,为管理员提供解决中断和标识配置错误的资产的起点。 该工具不能取代对受保护的构造进行操作的声音,只是为了快速验证日常操作过程中遇到的最常见问题。
有关本文中使用的 cmdlet 的完整文档,请参阅 HgsDiagnostics 模块参考。
Note: 运行受保护的结构诊断工具 (Get-HgsTrace -RunDiagnostics) 时可能会返回不正确的状态,声明 HTTPS 配置已损坏,而其实际上并未损坏或未使用。 无论 HGS 的证明模式如何,都可以返回此错误。 根本原因可能是:
- HTTPS 确实未正确配置/已损坏
- 你使用的是管理员信任的证明,并且信任关系已损坏 -这与 HTTPS 配置正确、错误或根本不相同无关。
请注意,诊断仅在面向 Hyper-V 主机时返回此不正确的状态。 如果诊断面向主机保护者服务服务,将返回正确的状态。
快速启动
您可以通过使用具有本地管理员权限的 Windows PowerShell 会话调用以下内容来诊断受保护的主机或 HGS 节点:
Get-HgsTrace -RunDiagnostics -Detailed
这会自动检测当前主机的角色,并诊断可以自动检测到的任何相关问题。 在此过程中生成的所有结果都是由于存在开关而显示的 -Detailed 。
本主题的其余部分将提供有关的高级用法的详细演练, Get-HgsTrace 如一次诊断多个主机和检测复杂的跨节点错误配置。
诊断概述
受保护的结构诊断在安装了与虚拟机相关的工具和功能的任何主机上可用,包括运行服务器核心的主机。 目前,诊断包含在以下功能/包中:
- 主机保护者服务角色
- 主机保护者 Hyper-V 支持
- 用于结构管理的 VM 防护工具
- 远程服务器管理工具 (RSAT)
这意味着,可以在所有受保护的主机、HGS 节点、特定的构造管理服务器以及安装了 RSAT 的任何 Windows 10 工作站上使用诊断工具。 可以从上述任一计算机调用诊断,并在受保护的构造中诊断任何受保护的主机或 HGS 节点;使用远程跟踪目标时,诊断可以查找并连接到运行诊断的计算机以外的其他主机。
诊断目标的每个主机称为 "跟踪目标"。 跟踪目标由其主机名和角色标识。 角色描述给定跟踪目标在受保护的构造中执行的函数。 目前,trace 目标支持 HostGuardianService 和 GuardedHost 角色。 请注意,主机可以同时占用多个角色,诊断也支持这种情况,但不应在生产环境中执行此操作。 HGS 主机和 Hyper-v 主机应始终保持独立和不同。
管理员可以通过运行来开始任何诊断任务 Get-HgsTrace 。 此命令基于运行时提供的开关执行两个不同的功能:跟踪收集和诊断。 这两者共同构成了受保护的结构诊断工具。 尽管没有明确要求,但最有用的诊断需要跟踪,这些跟踪只能在跟踪目标上通过管理员凭据收集。 如果用户执行跟踪集合所持有的权限不足,则需要提升的跟踪将会失败,而其他的跟踪将会失败。 这允许在有权限的操作员执行会审的情况下进行部分诊断。
跟踪集合
默认情况下, Get-HgsTrace 将只收集跟踪并将其保存到临时文件夹中。 跟踪采用名为的文件夹的形式,在目标主机后以特殊格式的文件进行填充,这些文件描述了如何配置主机。 跟踪还包含元数据,用于描述如何调用诊断以收集跟踪。 在执行手动诊断时,诊断将使用此数据来解除冻结有关主机的信息。
如有必要,可以手动查看跟踪。 所有格式都是用户可读的 (XML) ,也可以使用标准工具 (,例如 X509 证书和 Windows 加密外壳扩展) 。 但请注意,跟踪并不是针对手动诊断设计的,并且通过诊断功能处理跟踪始终更为有效 Get-HgsTrace 。
运行跟踪收集的结果不会指示给定主机的运行状况。 它们只是指示已成功收集跟踪。 需要使用诊断工具 Get-HgsTrace 来确定跟踪是否指示出现故障的环境。
使用 -Diagnostic 参数,你可以将跟踪集合限制为仅限操作指定诊断所需的跟踪。 这会减少收集的数据量,以及调用诊断所需的权限。
诊断
可以通过 Get-HgsTrace 参数提供跟踪的位置 -Path 并指定开关来诊断收集的跟踪 -RunDiagnostics 。 此外,还 Get-HgsTrace 可以通过提供 -RunDiagnostics 开关和跟踪目标列表在单个传递中执行收集和诊断。 如果未提供任何跟踪目标,则将当前计算机用作隐式目标,其角色通过检查已安装的 Windows PowerShell 模块来推断。
诊断将提供分层格式的结果,显示哪些跟踪目标、诊断集和个别诊断负责特定故障。 如果可以根据接下来应执行的操作进行确定,则故障包括修正和解决建议。 默认情况下,将隐藏传递和不相关的结果。 若要查看诊断测试的所有内容,请指定 -Detailed 开关。 这将导致显示所有结果,而不考虑它们的状态。
可以使用参数限制运行的诊断集 -Diagnostic 。 这允许您指定应针对跟踪目标运行的诊断类,并禁止所有其他类。 可用诊断类的示例包括网络、最佳做法和客户端硬件。 有关可用诊断的最新列表,请参阅 cmdlet 文档 。
Warning: 诊断不能代替强大的监视和事件响应管道。 有一个 System Center Operations Manager 包可用于监视受保护的构造,还提供了各种事件日志通道,可以监视这些通道以便及早检测问题。 然后,可以使用诊断快速诊断这些故障,并建立一系列操作。
面向诊断
Get-HgsTrace 针对跟踪目标进行操作。 跟踪目标是与某个 HGS 节点或受保护的构造中的受保护主机相对应的对象。 可以将它视为一个扩展, PSSession 其中包含只有诊断(如构造中的主机角色)所需的信息。 目标可以隐式生成 (例如本地或手动诊断) 或用命令显式生成 New-HgsTraceTarget 。
本地诊断
默认情况下, Get-HgsTrace 将以本地主机为目标 (即) 调用 cmdlet 的位置。 这称为隐式本地目标。 仅当参数中未提供任何目标且在中找不到预先存在的跟踪时,才使用隐式本地目标 -Target -Path 。
隐式本地目标使用角色推理来确定当前主机在受保护的构造中所扮演的角色。 这取决于已安装的 Windows PowerShell 模块,这些模块大致对应于系统上已安装的功能。 此模块的状态 HgsServer 将导致跟踪目标承担角色并且该模块的 HostGuardianService 状态 HgsClient 将导致跟踪目标承担该角色 GuardedHost 。 给定主机可以同时出现这两种模块,在这种情况下,它将被视为 HostGuardianService 和 GuardedHost 。
因此,默认情况下,诊断在本地收集跟踪:
Get-HgsTrace
...等效于以下内容:
New-HgsTraceTarget -Local | Get-HgsTrace
Tip:
Get-HgsTrace可以通过管道或直接通过参数来接受目标-Target。 这两个操作之间没有区别。
使用跟踪目标的远程诊断
可以通过使用远程连接信息生成跟踪目标来远程诊断主机。 所有所需的都是主机名和一组可以使用 Windows PowerShell 远程处理进行连接的凭据。
$server = New-HgsTraceTarget -HostName "hgs-01.secure.contoso.com" -Role HostGuardianService -Credential (Enter-Credential)
Get-HgsTrace -RunDiagnostics -Target $server
此示例将生成一个提示,收集远程用户凭据,然后将使用远程主机在上运行诊断, hgs-01.secure.contoso.com 以完成跟踪收集。 生成的跟踪将下载到 localhost,然后进行诊断。 诊断结果与执行 本地诊断时的结果相同。 同样,不需要指定角色,因为它可以根据远程系统上安装的 Windows PowerShell 模块进行推断。
远程诊断利用 Windows PowerShell 远程处理来访问远程主机。 因此,跟踪目标是启用 Windows PowerShell 远程处理的先决条件 (参阅 Enable enable-psremoting) ,并正确配置了 localhost 以启动与目标的连接。
Note: 在大多数情况下,只需将 localhost 作为同一个 Active Directory 林的一部分,并使用有效的 DNS 主机名。 如果你的环境使用更复杂的联合身份验证模型或者你希望使用直接 IP 地址进行连接,则可能需要执行其他配置,例如设置 WinRM 受信任的主机。
可以通过使用 cmdlet 验证跟踪目标是否已正确实例化并配置为接受连接 Test-HgsTraceTarget :
$server = New-HgsTraceTarget -HostName "hgs-01.secure.contoso.com" -Role HostGuardianService -Credential (Enter-Credential)
$server | Test-HgsTraceTarget
$True当且仅当 Get-HgsTrace 能够与跟踪目标建立远程诊断会话时,此命令将返回。 如果失败,此 cmdlet 将返回相关的状态信息,以便进一步排查 Windows PowerShell 远程处理连接问题。
隐式凭据
从具有足够权限的用户执行远程诊断以远程连接到跟踪目标时,无需向提供凭据 New-HgsTraceTarget 。 Get-HgsTrace当打开连接时,cmdlet 将自动重复使用调用该 cmdlet 的用户的凭据。
Warning: 某些限制适用于重用凭据,特别是在执行所谓的 "第二跃点" 时。 当尝试将凭据从远程会话内部重新使用到另一台计算机时,会发生这种情况。 需要 设置 CredSSP 以支持此方案,但这不在受保护的结构管理和故障排除范围内。
使用 Windows PowerShell 的管理 (JEA) 和诊断
远程诊断支持使用 JEA 约束的 Windows PowerShell 终结点。 默认情况下,远程跟踪目标将使用默认 microsoft.powershell 终结点进行连接。 如果跟踪目标具有 HostGuardianService 角色,它还将尝试使用在 microsoft.windows.hgs 安装 HGS 时配置的终结点。
如果要使用自定义终结点,则在使用参数构造跟踪目标时必须指定会话配置名称,如下所示 -PSSessionConfigurationName :
New-HgsTraceTarget -HostName "hgs-01.secure.contoso.com" -Role HostGuardianService -Credential (Enter-Credential) -PSSessionConfigurationName "microsoft.windows.hgs"
诊断多个主机
可以一次传递多个跟踪目标 Get-HgsTrace 。 这包括本地和远程目标的混合。 每个目标将依次跟踪,然后将同时诊断每个目标的跟踪。 诊断工具可以使用部署的更多知识来识别不能检测到的复杂跨节点错误配置。 使用此功能只需要在手动诊断) 的情况下,同时从多个主机提供跟踪 (,或在 Get-HgsTrace 远程诊断) 的情况下调用 (时以多个主机为目标提供跟踪。
下面的示例使用远程诊断来对由两个 HGS 节点和两个受保护的主机(其中一个受保护的主机用于启动)组成的构造进行会审 Get-HgsTrace 。
$hgs01 = New-HgsTraceTarget -HostName "hgs-01.secure.contoso.com" -Credential (Enter-Credential)
$hgs02 = New-HgsTraceTarget -HostName "hgs-02.secure.contoso.com" -Credential (Enter-Credential)
$gh01 = New-HgsTraceTarget -Local
$gh02 = New-HgsTraceTarget -HostName "guardedhost-02.contoso.com"
Get-HgsTrace -Target $hgs01,$hgs02,$gh01,$gh02 -RunDiagnostics
Note: 诊断多个节点时,无需诊断整个受保护的构造。 在许多情况下,足以包含可能涉及到给定故障条件的所有节点。 这通常是受保护的主机的一个子集和一个来自 HGS 群集的多个节点。
使用保存的跟踪进行手动诊断
有时,你可能想要重新运行诊断而不重新收集跟踪,或者你可能不具有用于远程诊断构造中的所有主机的必要凭据。 手动诊断是一种机制,通过该机制,你仍可以使用执行整个结构分类 Get-HgsTrace ,但不使用远程跟踪集合。
在执行手动诊断之前,你将需要确保构造中将要会审的每个主机的管理员都已准备就绪,并愿意以你的名义执行命令。 诊断跟踪输出不公开通常被视为敏感信息的任何信息,但用户有权确定是否可以安全地向他人公开此信息。
Note: 跟踪不匿名和显示网络配置、PKI 设置以及有时被视为专用信息的其他配置。 因此,跟踪只应传输到组织内的受信任实体,而永远不会公开发布。
执行手动诊断的步骤如下所示:
-
请求每个主机管理员
Get-HgsTrace指定一个已知的-Path,并请求您要针对生成的跟踪运行的诊断列表。 例如:Get-HgsTrace -Path C:\Traces -Diagnostic Networking,BestPractices -
请求每个主机管理员将生成的跟踪文件夹打包,并将其发送给您。 此过程可通过电子邮件、文件共享或任何其他机制(基于组织建立的操作策略和过程)驱动。
-
将所有接收的跟踪合并到一个文件夹中,无其他内容或文件夹。
-
例如,假设你已将管理员从名为 HGS-01、HGS-02、RR1N2608 和 RR1N2608 的四台计算机发送跟踪。 每个管理员都将使用相同的名称向您发送文件夹。 将显示如下所示的目录结构:
FabricTraces |- HGS-01 | |- TargetMetadata.xml | |- Metadata.xml | |- [any other trace files for this host] |- HGS-02 | |- [...] |- RR1N2608-12 | |- [...] |- RR1N2608-13 |- [..]
-
-
执行诊断,提供参数上已汇编的跟踪文件夹的路径,
-Path并指定-RunDiagnostics开关以及您要求管理员收集跟踪的诊断信息。 诊断将假定它无法访问在路径中找到的主机,因此将尝试仅使用预先收集的跟踪。 如果任何跟踪丢失或损坏,诊断将仅失败受影响的测试并正常运行。 例如:Get-HgsTrace -RunDiagnostics -Diagnostic Networking,BestPractices -Path ".\FabricTraces"
将保存的跟踪与其他目标混合
在某些情况下,你可能会有一组预先收集的跟踪,你希望使用其他主机跟踪来补充这些跟踪。 可以将预先收集的跟踪与其他目标混合,这些目标将在一次诊断调用中进行跟踪和诊断。
按照说明收集并组装上面指定的跟踪文件夹, Get-HgsTrace 使用在预收集的跟踪文件夹中找不到的附加跟踪目标调用:
$hgs03 = New-HgsTraceTarget -HostName "hgs-03.secure.contoso.com" -Credential (Enter-Credential)
Get-HgsTrace -RunDiagnostics -Target $hgs03 -Path .\FabricTraces
诊断 cmdlet 将标识所有预收集的主机,以及仍需要跟踪并执行必要跟踪的其他主机。 然后,将诊断所有预先收集和刚收集的跟踪的总和。 生成的 trace 文件夹将包含新跟踪和新跟踪。
已知问题
当在 Windows Server 2019 或 Windows 10、版本1809和更高版本的操作系统上运行时,受保护的结构诊断模块具有已知的限制。 使用以下功能可能导致错误的结果:
- 主机密钥证明
- 仅证明 (适用于 SQL Server Always Encrypted 方案的 HGS 配置)
- 在其证明策略默认为 v2 的 HGS 服务器上使用 v1 策略项目
Get-HgsTrace使用这些功能时出现故障,不一定表示 HGS 服务器或受保护的主机配置错误。
使用 Get-HgsClientConfiguration 受保护主机上的其他诊断工具来测试主机是否已通过证明。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpsqrd)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
