使用支持诊断工具排查 Azure Stack HCI 问题

2025/05/21

适用于：Azure Stack HCI 版本 22H2

本文提供了有关下载和使用 Azure Stack HCI 支持诊断工具的信息。该工具是一组 PowerShell 命令，用于简化常见问题的数据收集、故障排除和解决。

该工具不能替代专家知识。如果遇到任何问题，请联系 Azure 支持以获取帮助。

优点

Azure Stack HCI 支持诊断工具使用简单的命令来识别问题，无需具有专家级的产品知识。

该工具具有以下特点：

轻松安装和更新：可以使用 PowerShell 库以原生方式安装和更新，无任何额外的要求。
诊断检查：根据常见问题、事件和遥测数据提供诊断检查。
自动数据收集：自动收集重要数据，以便提供给 Azure 支持。
定期更新：通过新的检查和实用的命令进行更新，以管理、排查和诊断 Azure Stack HCI 上的问题。

先决条件

在使用 PowerShell 模块之前：

请确保使用对 Azure Stack HCI 具有管理访问权限的帐户。
确保在 Azure Stack HCI 上配置 PSRemoting。运行 Enable-PSRemoting 以配置远程 PowerShell。有关详细信息，请参阅 Enable-PSRemoting 参考文档。

安装或更新 Azure 本地支持诊断工具

以管理员身份运行 PowerShell，然后运行以下命令：

若要安装该工具，请运行以下命令：

Install-Module -Name Microsoft.AzureStack.HCI.CSSTools

如果已安装模块，可以使用以下 cmdlet 进行更新：

Update-Module -Name Microsoft.AzureStack.HCI.CSSTools

备注

导入模块时，它会尝试从 PowerShell 库自动更新。还可以使用以下方法手动更新。

通过删除和导入模块，确保已将最新模块加载到当前运行空间中。

Remove-Module -Name Microsoft.AzureStack.HCI.CSSTools
Import-Module -Name Microsoft.AzureStack.HCI.CSSTools

备注

确保 Azure Stack HCI 中的所有节点都已更新为使用相同的版本。删除现有的 PSSession，以确保将正确的模块版本加载到远程运行空间中。

使用 Azure 本地支持诊断工具

本部分提供用于使用 Azure 本地支持诊断工具的不同 cmdlet。

查看可用的 cmdlet

若要查看 PowerShell 模块中可用 cmdlet 的列表，请运行以下 cmdlet：

Get-Command -Module Microsoft.AzureStack.HCI.CSSTools

执行诊断检查

可以针对系统执行诊断运行状况检查，以帮助检测常见问题。提供以下组件：

BaseSystem
注册

Invoke-AzsSupportDiagnosticCheck -Component <Component>

收集数据以获取支持

若要使用预定义收集集之一收集数据，请运行以下命令：
```
New-AzsSupportDataBundle -Component <Component>
```
要检查所有数据收集组，请在 CTRL+SPACE 参数之后按 Component。

要收集自己的数据集，请运行以下命令：

$ClusterCommands = @(<clusterCommand1>,<clusterCommand2>)
$nodeCommands = @(<nodeCommand1>,<nodeCommand2>)
$nodeEvents = @(<eventLogName1>,<eventLogName2>)
$nodeRegistry = @(<registryPath1>,<registryPath2>)
$nodeFolders = @(<folderPath1>,<folderPath2>)


New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName @(<computerName1>,<computerName2>)

示例方案

要对 Azure Stack HCI 进行故障排除，请运行以下命令：

关于部署问题

要生成有关部署的详细报告，包括成功执行的步骤、跳过的步骤和错误详细信息，请运行以下命令：

Get-AzsSupportEceDeploymentDetails

关于更新或升级问题

Get-AzsSupportEceUpdateDetails

关于存储问题

Start-AzsSupportStorageDiagnostic

有关排查存储相关问题的完整指南，请参阅 Troubleshooting-Storage-With-Support-Diagnostics-Tool。

关于注册问题

Invoke-AzsSupportDiagnosticCheck -ProductName Registration

下面是注册问题的示例输出：

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -ProductName Registration
Starting known issue check for Azure Stack HCI: Registration.
Starting Azure Stack HCI base system validation.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Finished collecting diagnostic information.
====[ Validating registration state on node: HCI-N-1 ]====
[Pass] [Azure Stack HCI - General registration state]
Validate that the cluster is registered
Details: Validation successfull

[Fail] [Azure Stack HCI - Azure Connection state]
Validate that the cluster is in a connected state
Details: This Azure Stack HCI node does not seem to be connected to azure. Ensure that this node is in a connected state.
Documentation: https://docs.azure.cn/azure-stack/hci/deploy/troubleshoot-hci-registration

[Pass] [Azure Arc Agent - Connection state]
Validate that the azure arc agent is connected
Details: Validation successfull

[Pass] [Azure Arc Agent - Service state]
Validate that all azure arc services are running
Details: Validation successfull

[Pass] [Azure Arc Agent - Heartbeat state]
Validate that the azure arc agent has sent out a heartbeat at least a day ago
Details: Validation successfull

[Pass] [Azure Stack HCI - Arc Agent onboarded]
Validate that all arc agent checks are passed
Details: Validation successfull

[Fail] [Validation summary]
Details: At least one node reported an invalid registration state.
We will collect log information from your envirorment.
Creating local storage container for diagnostic data.
Gathering cluster data ... this might take a while.
Cluster data collection complete.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Waiting for all diagnostic output to be generated and compressed ... this might take a while.
Finished collecting diagnostic information.
Starting copy of items ... this might take a while.
All items copied.
Successfully created archive C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\log-collection-RegistrationInformation07-22_06-03-2024.zip. Removing raw data C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\container.
Data collection done . Please upload the file to the Microsoft Workspace.

关于基础 Azure Stack HCI 系统问题

Invoke-AzsSupportDiagnosticCheck -Component BaseSystem

下面是基本系统问题的示例输出：

PS C:\temp> Invoke-AzsSupportDiagnosticCheck -Component BaseSystem
Starting known issue check for Azure Stack HCI: BaseSystem.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Starting to validate cluster settings.
[Pass] [Failover Clustering - Cluster validation report contains no errors]
Validate that there are no critical errors in the cluster validation report
Details: Validation successfull

[Pass] [Failover Clustering - Cluster Networks have redundancy]
Validate that we have redundancy in clustered networks
Details: Validation successfull

[Pass] [Failover Clustering - Validation Summary]
Validate that there are no critical issues in our cluster validation report.
Details: Validation successfull

Collecting node data.
Finished collecting diagnostic information.
====[ Validating data from node: HCI-N-1 ]====
[Pass] [Windows Features - All windows features installed]
Verify that all features required for Azure Stack HCI are installed.
Details: Validation successfull

[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull

之后，将创建正确连接的 Azure Stack HCI 系统所需的不同组件的全面概述。根据此概述，可以遵循故障排除指南或联系 Azure 支持以获取帮助。

要收集数据，请参阅以下两个示例场景：

关于自动数据收集

New-AzsSupportDataBundle -Component OS
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace

关于手动数据收集

$ClusterCommands = @()
$nodeCommands = @('Get-AzureStackHci','Get-AzureStackHCIArcIntegration','Get-ClusteredScheduledTask | fl *','systeminfo.exe')
$nodeEvents = @('system','application','Microsoft-AzureStack-HCI/Admin')
$nodeRegistry = @('HKLM:\Cluster\ArcForServers')
$nodeFolders = @('C:\Windows\Tasks\ArcforServers\','C:\ProgramData\AzureConnectedMachineAgent\Log\')

New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName (Get-ClusterNode)

==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace.

通过