解决 Windows Admin Center 中的问题

如果刚刚创建了一个新的 Azure 帐户，但尚未登录到网关计算机上的帐户，则可能会在将 Windows Admin Center 网关注册到 Azure 时遇到问题。

若要缓解此问题，请在另一个浏览器选项卡或窗口中登录到 Azure 帐户，然后将 Windows Admin Center 网关注册到 Azure。

通过 Windows Admin Center 在 Azure 本地部署Azure Kubernetes 服务时，只有设置 AKS 主机的用户才能创建 Kubernetes 群集。

若要解决此问题，请将 wssd 文件夹从设置 AKS 主机的用户的配置文件复制到将创建新 Kubernetes 群集的用户的配置文件。

遇到部署问题或想要重置部署。

从 PowerShell 管理窗口运行 Uninstall-AksHci 之前，请关闭连接到 Azure 本地Azure Kubernetes 服务的所有 Windows Admin Center 实例。

你可能会在任一向导中收到有关配置错误的错误。

执行群集清理操作。 这些操作可能涉及删除 C：\Program Files\AksHci\mocctl.exe 文件。

主机群集部署流和工作负荷群集部署流中显示的网络字段名称不一致。

空值

如果已禁用弹出窗口，则会出现此错误。 默认情况下，Google Chrome 会阻止弹出窗口，因此，Azure 登录弹出窗口被阻止，并导致服务主体错误。

启用弹出窗口。

从 DHCP 切换到静态 IP 时，Windows Admin Center 会显示一个错误，指出 WinRM 客户端无法处理请求。 此错误也发生在 Windows Admin Center 之外。 使用静态 IP 地址时 WinRM 中断，且在移动到静态 IP 地址时，服务器未注册服务主体名称 (SPN)。

若要解决此问题，请使用 SetSPN 命令创建 SPN。 在 Windows Admin Center 网关上的命令提示符下运行以下命令：

Setspn /Q WSMAN/<FQDN on the Azure Local machine> 

接下来，如果环境中的任何计算机返回消息 No Such SPN Found，请登录到该计算机并运行以下命令：

Setspn /S WSMAN/<machine name> <machine name> 
Setspn /S WSMAN/<FQDN of machine> <machine name> 

最后，在 Windows Admin Center 网关上运行以下命令，确保它从域控制器获取新计算机信息：

Klist purge 

如果收到错误升级通知消息“已成功安装 AksHci PowerShell 模块版本 null”，即使通知具有误导性，升级操作也会成功。

可以安全地忽略此消息。

在阶段 2.1：基本步骤组件中，可能会遇到此错误：“连接到远程服务器 *** 失败，出现以下错误消息：拒绝访问。 有关详细信息，请参阅尝试将凭据用于服务器节点时about_Remote_Troubleshooting帮助主题”。

确保添加的帐户/凭据是计算机上的管理帐户。 然后，验证是否启用了 PSRemoting，远程主机是否受信任。 可以使用以下 PowerShell 命令来执行此操作：

Enable-PSRemoting -Force 
winrm quickconfig 

如果仍遇到问题， 请参阅此故障排除指南。

Windows Admin Center 当前没有从 Azure Arc 卸载群集的过程。

若要删除已销毁的群集上的 Arc 代理，请导航到Azure 门户中的群集资源组，并手动删除 Arc 内容。 若要删除仍在启动和运行的群集上的 Arc 代理，应运行以下命令：

az connectedk8s delete --name AzureArcTest1 --resource-group AzureArcTest

升级成功后，Windows Admin Center 更新仪表板仍显示先前的版本。

刷新浏览器以解决此问题。

使用 Windows Admin Center 部署 AKS Arc 时，部署挂起一段时间后，可能会遇到凭据安全支持提供程序（CredSSP）或连接问题。

请尝试以下步骤排查部署问题：

1. 在运行 Windows Admin Center 的计算机上，在 PowerShell 窗口中运行以下命令：

      Enter-PSSession <servername>
   

2. 如果此命令成功，则可以连接到服务器，并且没有连接问题。

3. 如果遇到 CredSSP 问题，请运行以下命令以测试网关计算机与目标计算机之间的信任：

      Enter-PSSession -ComputerName <server> -Credential company\administrator -Authentication CredSSP
   

   还可以运行以下命令来测试访问本地网关的信任：

      Enter-PSSession -computer localhost -credential (Get-Credential)
   

有关其他 CredSSP 故障排除提示，请参阅 CredSSP 故障排除。

有时，由于网络问题，Windows Admin Center 在 Arc 连接期间超时。

使用 PowerShell 命令 Enable-AksHciArcConnection 将 AKS 工作负荷群集连接到 Azure Arc，同时积极改进用户体验。

在阶段 2.1：系统验证中，可能会收到错误：“项”Install-Module“未识别为 cmdlet、函数、脚本文件或可运行的程序的名称”。

检查名称的拼写。 如果包含路径，请确保路径正确。 然后在安装时重试。 在尝试部署到的节点上完成 PowerShell 命令。 运行以下命令来解决此问题（确保 PowerShell 版本至少为 5.1）：

Install-Module -Name PowershellGet -Repository PSGallery -Force -Confirm:$false -SkipPublisherCheck

如果在第一个命令中遇到任何错误，请运行以下命令：

Get-PSRepository
Register-PSRepository -Default

无法将 Windows Admin Center 连接到 Azure，因为无法在网关上自动创建和使用Azure 应用 ID。

创建Azure 应用 ID，并在门户中为其分配适当的权限。 然后选择“ 在网关中使用现有”。 有关详细信息，请访问 将网关连接到 Azure。

如果工作负载群集安装有 Kubernetes 版本 1.19.9，然后使用 Windows 管理中心将其更新为 Kubernetes 版本 1.19.11，则 Kubernetes 更新页将继续显示更新仍在进行中。 但是，如果你运行 Get-AksHciCluster，则输出会显示更新已完成，如果你在新选项卡中打开 Windows 管理中心，则群集将更新为 Kubernetes 群集列表中的 1.19.11。

可以忽略此问题，因为更新过程确实已完成。

报告 Windows Admin Center 问题时，最好附加日志以帮助开发团队诊断问题。 Windows Admin Center 中的错误通常分为以下两种形式之一：

• 运行 Windows Admin Center 的计算机上的事件查看器中显示的事件
• 浏览器控制台中显示的 JavaScript 问题

若要收集 Windows Admin Center 的日志，请使用 Get-SMEUILogs.ps1 公共预览版包中提供的脚本。

若要使用该脚本，请在存储脚本的文件夹中运行以下命令：

./Get-SMEUILogs.ps1 -ComputerNames [comp1, comp2, etc.] -Destination [comp3] -HoursAgo [48] -NoCredentialPrompt

该命令具有以下参数：

• -ComputerNames：要从中收集日志的计算机的列表。
• -Destination：要将日志聚合到的计算机。
• -HoursAgo：收集日志的开始时间，以运行脚本前几个小时表示。
• -NoCredentialPrompt：关闭凭据提示的开关，并在当前环境中使用默认凭据。

如果运行此脚本时遇到困难，可以运行以下命令来查看帮助文本：

GetHelp .\Get-SMEUILogs.ps1 -Examples

在 Windows Admin Center 运行升级时，出现以下错误：

Error occurred while fetching platform upgrade information. RemoteException: No match was found for the specified search criteria and module name 'AksHci'. Try Get-PSRepository to see all available registered module repositories.

当 Azure 本地上的 AKS 部署在配置了代理的环境中时，通常会发生此错误消息。 目前，Windows Admin Center 不支持在代理环境中安装模块。

若要解决此错误，请使用代理 PowerShell 命令在 Azure 本地设置 AKS。

AKS 主机群集部署在系统检查时失败，并出现 WinRM 服务错误。

尝试应用手动故障排除中建议的解决方案。

如果安装了多个版本的 PowerShell 模块（例如 0.2.26、0.2.27 和 0.2.28），Windows Admin Center 可能不会使用最新版本（或它所需的版本）。

确保只安装了一个 PowerShell 模块。 应卸载所有未使用的 PowerShell 版本的 PowerShell 模块，并只保留一个已安装的版本。 有关哪些 Windows Admin Center 版本与哪些 PowerShell 版本兼容的详细信息，请参阅 Azure 本地发行说明上的 AKS。

通过 Windows Admin Center 部署时出现此错误。 包提供程序需要 PackageManagement 标记和 Provider 标记。 在尝试通过 Windows Admin Center 部署时，应检查指定的包是否有标记错误。

此错误来自 PowerShell，并指出存在 Internet 连接问题。 PowerShell 正在尝试安装必备组件包，并且无法安装它。

检查以确保服务器或故障转移群集具有 Internet 连接，然后启动全新安装。

在阶段 2.1：系统验证中，在尝试 No match was found for the specified search criteria for the provider 'NuGet'. The package provider requires 'PackageManagement' and 'Provider' tags. Please check if the specified package has the tags. 部署到的节点上完成 PowerShell 命令时，可能会出现错误。 必须使用以下 PowerShell 命令手动安装 NuGet：

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

运行此命令后，关闭所有打开的 PowerShell 窗口，并在 Windows Admin Center 中重试。

在阶段 2.1：系统验证中，可能会遇到以下错误：“找不到存储库”PSGallery”。

单击“安装”时，使用 Get-PSRepository 查看所有可用的存储库。 在尝试部署到的节点上完成 PowerShell 命令。 在管理 PowerShell 窗口中注销并重新注册 PSRepository。 关闭之后的所有 PowerShell 窗口。

Unregister-PSRepository -Name 'PSGallery'
Register-PSRepository -Default

然后在管理 PowerShell 窗口中卸载并重新安装 PowerShellGet。 关闭之后的所有 PowerShell 窗口。

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

之后，返回到 Windows Admin Center，然后重试。

如果使用一个帐户安装 Windows Admin Center 并尝试将其用于另一个帐户，则会收到错误。

若要在群集创建向导中成功运行 CredSSP，必须安装并使用相同的帐户安装并使用 Windows Admin Center。

从 PowerShell 迁移到 Windows Admin Center 以创建已启用 Arc 的工作负荷群集时，会出现此错误。

你可以放心忽略此错误。 它是验证步骤的一部分，并且群集已创建。

重启托管管理群集和工作负荷群集的 Azure 本地群集节点可能会导致工作负荷群集从 Windows Admin Center 仪表板中消失。

若要绕过此问题，请在计划重启节点之前暂停和排出节点。 有时，工作负载群集可能需要较长时间才能在仪表板中显示。

Windows Admin Center 不会将Azure Kubernetes 服务部署到具有单独存储和计算群集的环境，因为它期望同一群集提供计算和存储资源。 在大多数情况下，它不会发现计算群集公开的 CSV，并且将拒绝继续部署。

后续步骤

• 疑难解答概述
• 安装问题和错误
• 已知升级问题

如果在使用 AKS Arc 时继续遇到问题，可以通过 GitHub 提交 bug。