Azure 本地中的已知问题

本文介绍 Azure 本地中的关键已知问题及其解决方法。

这些发行说明会不断更新,遇到需要解决方法的关键问题时,会将它们添加到说明中。 在部署 Azure 本地实例之前,请仔细查看此处包含的信息。

重要

有关此版本的受支持更新路径的信息,请参阅 发布信息

有关此版本中的新功能的详细信息,请参阅 Azure 本地的新增功能。

版本 2506 的已知问题

对于 Azure Local 的 2506 版本,Microsoft发布了两个安全更新,每个更新都与特定的 OS 版本保持一致。 下表提供特定版本及其 OS 版本:

解决方案版本 OS 内部版本
11.2506.1001.28 25398.1665
12.2506.1001.29 26100.4349

重要

此软件的新部署使用 12.2506.1001.29 构建版本。 还可以使用 11.2506.1001.28 从 2505 更新现有部署。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

下表列出了此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地虚拟机 创建 VM 时,无法提示输入密码。 当未显式传递 --password 时,会提示输入密码。 这为客户提供了一种更安全的方式来输入密码。
Azure 本地虚拟机 创建 VM 时,启用来宾管理需要 --admin-username--password 来宾管理启用的非限制性要求。 现在,在创建 VM 时,除非提供了 OS 磁盘或 --authentication-typessh,否则 --admin-username--password 是必需的。
Azure 本地虚拟机 在某些情况下,VM 更新操作在底层基础设施中失败,但在 Azure 门户中被错误地显示为成功。 改进了错误报告,以确保 Azure 门户准确反映 VM 更新作的真实状态。
Azure 本地虚拟机 删除具有附加 AKS 群集的逻辑网络会留下孤立的本地资源。 在逻辑网络删除期间正确检测和处理 AKS 群集依赖项,以防止资源泄漏。
Azure 本地虚拟机 无法使用 --download-url 创建 VHDs 在分配下载 URL 之前正确初始化 VHD 属性,确保成功创建磁盘。
Azure 本地虚拟机 在某些情况下,从多个平台(Azure 门户、Windows 管理中心、故障转移群集管理器)中移除虚拟机可能会导致其高可用性(HA)状态停滞在“挂起”状态。 从群集中删除 VM 时正确更新 HA 状态,防止 VM 停滞。
Azure 本地虚拟机 创建 VM 后,有时会附加用于来宾代理设置的临时 ISO 文件。 创建 VM 后,会自动删除 ISO 文件。
Azure 本地虚拟机 在某些情况下,VM 删除未正确清理关联的网络接口或磁盘,留下孤立的资源,阻止重复使用 IP 地址和存储。 删除 VM 时,将正确分离和删除所有依赖资源,从而防止资源泄漏。
Azure 本地虚拟机 改进了基础结构范围的 IP 地址的验证。
Azure 本地虚拟机 改进了加载 PowerShell 模块的行为。
Azure 本地虚拟机 添加了标志,以便在重新附加卷时启用卷解密。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
安全性 在正常作(例如,更新、修复)中使用 Defender for Endpoint 时以及部署中的一个或多个服务器启用了 “限制应用执行 ”设置时,Azure 本地可能会遇到问题。 在 Defender 门户中禁用 “限制应用执行 ”设置并重新启动。 如果问题仍然存在, 请提出支持案例
部署 在极少数情况下,部署在验证期间失败并出现错误,指出尚未安装强制 Arc 扩展。 如果遇到此问题,请重试部署。
部署 部署失败,出现 PSTerminatingError。 如果遇到此问题,请重试部署。
更新 解决方案更新失败,并出现错误: Unable to install solution update "11.2506.1001.24" - Type 'UpdateFOD' of Role 'ComposedImageUpdate' raised an exception. 有关如何解决此问题的详细步骤,请参阅 故障排除指南
部署 在 Azure 门户部署后,SConfig 网络设置会显示错误: Set-SCfNetworksetting : Cannot bind argument to parameter 'Value' because it is null. 此版本中没有已知的解决方法。
更新 Cluster-Aware 更新过程可能会失败,并出现错误:
Type 'SBEPartnerConfirmCauDone' of Role 'SBE' raised an exception:<br>SBE_MsftCIOnlyCommon_CommonForTesting_4.2.2504.16: ErrorID: SBE-CAU-RUNNING-AFTER-DONE -- CAU run is still in progress when it should be done. See https://aka.ms/AzureLocal/SBE/CauHelp for help. Review full Get-CauRun output it identify if it is progressing or stuck. Wait for it to complete if progressing.
等待 CAU 运行完成(等待 Get-CauRun 报告 RunNotInProgress)并恢复更新。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
添加服务器
修复服务器
Add-serverRepair-server cmdlet 失败并出现错误:
Cluster Build ID matches node to add's Build ID
使用与在现有群集上运行的相同解决方案版本的 OS 映像。 若要获取 OS 映像,请从此 发布表标识并下载映像版本。
部署 在此版本和以前的版本中,尝试将 Azure 本地计算机注册到 Azure Arc 时,注册失败并出现以下错误:
AZCMAgent command failed with error: >> exitcode: 42. Additional Info: See https://aka.ms/arc/azcmerror
有关如何解决此问题的详细步骤,请参阅 故障排除指南
Azure 本地 VM 管理 Mochostagent 服务可能似乎正在运行,但可能会停滞,而不会更新日志一个多月。 可以通过检查 C:\programdata\mochostagent\logs 中的服务日志来识别此问题,以查看日志是否已更新。 运行以下命令以重启 mochostagent 服务:restart-service mochostagent
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 在此版本中存在间歇性问题,当 Azure 门户错误地将更新状态报告为 “无法更新 ”或 “正在进行”,而实际上更新已经完成。 通过远程 PowerShell 会话连接到 Azure 本地实例。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户在 24 小时内正确刷新服务状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理旁路列表不会更新 Azure 资源网桥或 AKS 上的代理旁路列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 本地 VM 管理 Azure 本地 VM 上的 Arc 扩展会无限期保持“创建”状态。 登录到 VM,打开命令提示符,然后键入以下内容:
Windows
notepad C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json
Linux
sudo vi /var/opt/azcmagent/agentconfig.json
接下来,查找 resourcename 属性。 删除追加到资源名称末尾的 GUID,以使该属性与 VM 的名称匹配。 然后,重启 VM。
Azure 本地 VM 管理 Azure 本地 VM 操作的重启大约在 20 分钟后完成,尽管 VM 本身在大约一分钟内重新启动。 此版本中没有已知的解决方法。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure 本地实例时,更新进度和结果可能在 Azure 门户中不可见。 若要解决此问题,请在每个节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。
升级 升级横幅目前适用于使用 Azure 政府云的用户。 但是,环境检查器会失败,这表明不支持 Azure 政府云。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。

已知和预期行为

下表列出了不应被视为 bug 或限制的已知和预期系统行为。

功能 / 特点 行为 解决方法
操作系统 Azure 本地不支持使用 RegBack 还原注册表。 此操作可以删除 Azure 本地实例上的生命周期管理器(LCM)和 Microsoft 本地云(MOC)设置,这可能会导致解决方案损坏。
Azure 本地 VM 管理 不支持将导出的 Azure VM OS 磁盘用作 VHD 来创建用于预配 Azure Local VM 的库映像。 运行命令 restart-service mochostagent 以重启 mochostagent 服务。

本文介绍 Azure 本地中的关键已知问题及其解决方法。

这些发行说明会不断更新,遇到需要解决方法的关键问题时,会将它们添加到说明中。 在部署 Azure 本地实例之前,请仔细查看此处包含的信息。

重要

有关此版本的受支持更新路径的信息,请参阅 发布信息

有关此版本中的新功能的详细信息,请参阅 Azure 本地的新增功能。

版本 2505 的已知问题

对于 Azure Local 的 2505 版本,Microsoft发布了两个安全更新:一个用于现有部署,另一个用于新部署。 下表提供有关不同部署类型、其相应安全更新和 OS 版本的信息:

部署类型 解决方案版本 OS 内部版本
现有部署 11.2505.1001.22 25398.1611
新部署 12.2505.1001.23 26100.4061

重要

此软件的新部署使用 12.2505.1001.23 版本。 还可以使用 11.2505.1001.22 从 2504 更新现有部署。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

下表列出了此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地虚拟机 创建磁盘和库映像时发生超时错误。 延长超时时间以支持更大的磁盘和映像大小。
Azure 本地虚拟机 Mocguestagent 卡在启动/停止循环中,无法连接到主机代理。 改进了 Mocguestagent 连接。
Azure 本地虚拟机 在 Hyper-V 中删除 VM 后,无法在 Azure 门户或 CLI 中删除 VM。 如果在 Hyper-V 中而不是在 Azure 门户或 CLI 中删除虚拟机,请在 Azure 门户或 CLI 中删除该资源以清理。
Azure 本地虚拟机 无法删除在创建 VM 期间无法附加的数据磁盘。 修复了数据磁盘的附件状态,以确保准确。 现在,如果数据磁盘在创建 VM 期间无法附加,则可以将其删除。
Azure 本地虚拟机 OS 更新可以在本月的第三个星期二(例如 5 月 20 日、6 月 17 日或 7 月 15 日)自动安装。 这可能会导致意外中断或将来的问题,因为 Azure 本地环境的操作系统版本不匹配。 删除了作为某些 SBE 更新一部分设置计划的 CAU 的逻辑。
部署 通过 Azure 资源管理器 (ARM) 模板进行部署失败,验证过程中出现以下错误:
Type 'DeployArb' of Role 'MocArb' raised an exception: [DeployArb:Fetching SP in CloudDeployment Scenario] Exception calling 'GetCredential' with '1' argument(s): 'Exception of type 'CloudEngine.Configurations.SecretNotFoundException' was thrown.' at at Get-CloudDeploymentServicePrincipal
错误是因为部署期间缺少 SPN。
有关如何解决此问题的详细步骤,请参阅 故障排除指南
解决方案扩展 更改了用于验证插件状态的运行状况检查的严重性级别。
Azure 门户 添加了一个修补程序,用于在重新部署期间提取存储帐户属性。
Azure 门户 在 Azure 本地下载期间添加了有关订阅访问权限的错误消息。
Azure 门户 如果在 Azure 本地下载期间未注册订阅,则添加了警告消息。
Azure 门户 改进了逻辑,以便在部署过程中可以选择启用 Azure Arc 的计算机。
Azure 门户 增强了部署期间计算机状态的设置。
Azure 门户 改进了错误处理和数据处理。
Azure 门户 添加了一个修复程序,用于在部署期间完成扩展安装之前禁用验证按钮。
部署 添加了验证以检查更改访问控制列表(ACL)所需的权限。
部署 向 WMI 调用添加了服务器端筛选器以提高性能并减少调用时间。
部署 添加了修复程序,以便在使用后处置 PowerShell 对象,从而在创建新的 PowerShell 实例时提高性能。
部署 修复了运行 “安装 Azure Stack HCI ”向导并选择时区时的时区问题。 “ 安装 Azure Stack HCI ”向导现在可正确应用部署期间所选时区。
安全管理 修复了在安全符合性报告中显示为“未知”安全默认值应用程序控件数据保护页。
添加服务器
修复服务器
修复了在 Azure 本地环境中,使用自定义存储适配器 IP 运行 Add-serverRepair-server cmdlet 时发生的错误:Type 'ConfigureAzureStackHostStorageAdpaterIPAddressesInAddRepairNode' of Role 'HostNetwork' raised an exception: Connecting to remote server <MACHINE> failed with the following error message: Access is denied.

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
更新 关键 VM作状态不正常警报显示在 Azure 门户中的 “更新就绪状态 ”下,并在更新成功完成后显示在“ 警报 ”窗格中。 此外,运行 Get-HealthFault cmdlet 时会显示警报。 你无需执行任何操作。 此警报将在几天内自动解决。
部署 通过 Azure 门户从 Azure 本地计算机页手动更新 Azure Arc 扩展将导致部署过程中出现问题。 不应手动更新的扩展包括: AzureEdgeDeviceManagementAzureEdgeLifecycleManagerAzureEdgeAKVBackupForWindows 不支持从 Azure 本地计算机页手动安装扩展。
升级 升级横幅目前适用于使用 Azure 政府云的用户。 但是,环境检查器会失败,这表明不支持 Azure 政府云。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
添加服务器
修复服务器
Add-serverRepair-server cmdlet 失败并出现错误:
Cluster Build ID matches node to add's Build ID
使用与在现有群集上运行的相同解决方案版本的 OS 映像。 若要获取 OS 映像,请从此 发布表标识并下载映像版本。
部署 在此版本和以前的版本中,尝试将 Azure 本地计算机注册到 Azure Arc 时,注册失败并出现以下错误:
AZCMAgent command failed with error: >> exitcode: 42. Additional Info: See https://aka.ms/arc/azcmerror
有关如何解决此问题的详细步骤,请参阅 故障排除指南
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理旁路列表不会更新 Azure 资源网桥或 AKS 上的代理旁路列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。
Azure Arc 注册 使用 Azure Arc 注册新计算机时,注册在ImageRecipeValidationTests期间失败并出现以下错误:
"Responses": [ { "Name": "ImageRecipeValidation", "Status": "Failed", "Errors": [ { "ErrorMessage": "Diagnostics failed for the test category: ImageRecipeValidation.", "StackTrace": null, "ExceptionType": "DiagnosticsTestFailedException", "RecommendedActions": [ "Please contact Microsoft support." ] } ] }
有关如何解决此问题的详细步骤,请参阅 故障排除指南
升级 由于在安全启动证书安装过程中丢失了 Virtualization-Based 安全(VBS)主密钥,无法升级Get-AzureStackHCI ConnectionStatus中的RepairRegistration群集。 有关如何解决此问题的详细步骤,请参阅 故障排除指南
注册 安装某些更新(包括 BIOS)后,群集可能会报告 RepairRegistrationRequired 并显示过时的连接状态。 有关如何解决此问题的详细步骤,请参阅 故障排除指南

已知和预期行为

下表列出了不应被视为 bug 或限制的已知和预期系统行为。

功能 / 特点 行为 解决方法
操作系统 Azure 本地不支持使用 RegBack 还原注册表。 此操作可以删除 Azure 本地实例上的生命周期管理器(LCM)和 Microsoft 本地云(MOC)设置,这可能会导致解决方案损坏。
Azure 本地 VM 管理 不支持将导出的 Azure VM OS 磁盘用作 VHD 来创建用于预配 Azure Local VM 的库映像。 运行命令 restart-service mochostagent 以重启 mochostagent 服务。

版本 2504 的已知问题

对于 Azure Local 的 2504 版本,Microsoft发布了两个安全更新:一个用于现有部署,另一个用于新部署。 下表提供有关不同部署类型、其相应安全更新和 OS 版本的信息:

部署类型 解决方案版本 OS 内部版本
现有部署 11.2504.1001.19 25398.1551
新部署 12.2504.1001.20 26100.3775

重要

此软件的新部署使用版本号 12.2504.1001.20。 还可以使用 11.2504.1001.19 从 2503 更新现有部署。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

下表列出了此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地虚拟机 如果 VM 是使用源映像和 OS 磁盘创建的,且它们位于同一 CSV 上,并且在源映像的上一个复制过程中发生了错误,则源映像上的后续部署或操作会失败。
Azure 本地虚拟机 无法创建的单个 Azure Local VM 的多个 Hyper-V VM 仍在 Azure Local 上运行。
Azure 本地虚拟机 如果存在 AKS 节点磁盘,则存储路径删除会超时。 没有超时,在出错时会显示正确的错误消息,列出存储路径上的资源。
Azure 本地虚拟机 删除群集上不再存在的其他资源所使用的资源时出现问题。 增强验证,用于在尝试删除之前检查群集上是否存在资源。
Azure 本地虚拟机 删除和重设具有检查点的 Azure Local VM 的大小时出现问题。 可以使用本地的内部工具为 Azure 本地虚拟机创建检查点。 虚拟机将仍可通过 Azure 门户进行管理。
解决方案扩展 改进了错误消息,以修复防火墙阻止访问解决方案扩展清单终结点的问题。
解决方案扩展 改进了在本地将解决方案扩展内容复制到每台计算机的可靠性。
解决方案扩展 在解决方案扩展中添加了插件名称的规范。
解决方案扩展 修复了系统无法获取可用解决方案扩展更新的问题。
更新 简化了用于查看更新运行进度和历史记录的 Azure 门户体验。
更新 在 Azure 更新管理门户中监视更新进度时,进度可能看起来没有更新几个小时。 在某个群集节点上运行 Get-SolutionUpdate。 如果返回更新对象,更新可能花费的时间可能比预期长,但它正在进行中。 如果未返回更新对象,则更新可能会停止。 有关如何解决此问题的详细步骤,请参阅 故障排除指南

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
添加服务器
修复服务器
Add-serverRepair-server cmdlet 失败并出现错误:
Cluster Build ID matches node to add's Build ID
使用与在现有群集上运行的相同解决方案版本的 OS 映像。 若要获取 OS 映像,请从此 发布表标识并下载映像版本。
添加服务器
修复服务器
如果在您的 Azure 本地实例中配置了自定义存储适配器 IP,运行 Add-serverRepair-server cmdlet 时,操作可能会失败并出现错误:
Type 'ConfigureAzureStackHostStorageAdpaterIPAddressesInAddRepairNode' of Role 'HostNetwork' raised an exception: Connecting to remote server <MACHINE> failed with the following error message : Access is denied.
如果遇到此问题,请联系Microsoft支持部门。
安全管理 “安全默认值”、“应用程序控制”和“数据保护”页显示“未知”的所有安全设置。 此问题仅在安全符合性报告中。 安全设置的状态不受影响。 使用 PowerShell 验证安全设置的符合性状态。

有关详细信息,请参阅 通过 PowerShell cmdlet 管理安全基线
部署 在此版本和以前的版本中,尝试将 Azure 本地计算机注册到 Azure Arc 时,注册失败并出现以下错误:
AZCMAgent command failed with error: >> exitcode: 42. Additional Info: See https://aka.ms/arc/azcmerror
有关如何解决此问题的详细步骤,请参阅 故障排除指南
Azure Arc 注册 使用 Azure Arc 注册新计算机时,注册在ImageRecipeValidationTests期间失败并出现以下错误:
"Responses": [ { "Name": "ImageRecipeValidation", "Status": "Failed", "Errors": [ { "ErrorMessage": "Diagnostics failed for the test category: ImageRecipeValidation.", "StackTrace": null, "ExceptionType": "DiagnosticsTestFailedException", "RecommendedActions": [ "Please contact Microsoft support." ] } ] }
有关如何解决此问题的详细步骤,请参阅 故障排除指南
部署 在 2504 版本中,运行 “安装 Azure Stack HCI ”向导并选择时区时,无论选择如何,系统都会继续使用太平洋标准时间(PST)。 这不是阻止问题,部署仍将成功完成。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理旁路列表不会更新 Azure 资源网桥或 AKS 上的代理旁路列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。
升级 由于在安全启动证书安装过程中丢失了 Virtualization-Based 安全(VBS)主密钥,无法升级Get-AzureStackHCI ConnectionStatus中的RepairRegistration群集。 有关如何解决此问题的详细步骤,请参阅 故障排除指南
注册 安装某些更新(包括 BIOS)后,群集可能会报告 RepairRegistrationRequired 并显示过时的连接状态。 有关如何解决此问题的详细步骤,请参阅 故障排除指南

已知和预期行为

下表列出了不应被视为 bug 或限制的已知和预期系统行为。

功能 / 特点 行为 解决方法
操作系统 Azure 本地不支持使用 RegBack 还原注册表。 此操作可以删除 Azure 本地实例上的生命周期管理器(LCM)和 Microsoft 本地云(MOC)设置,这可能会导致解决方案损坏。
Azure 本地 VM 管理 不支持将导出的 Azure VM OS 磁盘用作 VHD 来创建用于预配 Azure Local VM 的库映像。 运行命令 restart-service mochostagent 以重启 mochostagent 服务。

版本 2503 的已知问题

此软件发行版映射到软件版本号 2503.0.13

重要

此软件的新部署使用 2503.0.13 构建版本。 还可以从 2411.3 更新。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

下表列出了此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地虚拟机 由于内部服务进入死锁状态,创建或删除 Azure 本地 VM 时出现间歇性故障或超时。 现在可以部署 Azure 本地 VM,而不会遇到超时问题。
Azure 本地虚拟机 如果创建某个库映像时所基于的源 Azure Local VM 已删除,则无法删除该库映像。 现在,即使创建某个库映像时所基于的源 Azure Local VM 已删除,也可以删除该库映像。
Azure 本地虚拟机 Azure Arc 资源网桥灾难恢复后,某些 Azure 本地 VM 可能会失去网络连接。 更新了 Azure Arc 资源桥灾难恢复逻辑,以确保 Azure 本地 VM 的网络配置仍然存在。
Azure 本地虚拟机 从群集中删除 VM 的源映像时,Azure 上 Azure Local VM 的电源状态报告不准确。 电源操作在 Azure 上为已删除源映像的 Azure Local VM 显示一致且准确的电源状态表示形式。
Azure 本地虚拟机 尝试进行电源操作时,Azure 上 Azure Local VM 的电源状态报告不准确。 通过减少延迟和修复影响电源操作对 Azure 可见性的漏洞,提高了电源状态对账的准确性。
Azure 本地虚拟机 无法使用指定的存储路径创建图库图片。 现在可以创建具有指定存储路径的图库图像。
Azure 本地虚拟机 运行 azcmagent disconnect 会删除 Azure 本地 VM。 不要在 azcmagent disconnect Azure 本地 VM 上使用。 仅使用 azcmagent disconnect -fazcmagent disconnect --force-local-only。 此命令断开连接的计算机代理的连接,并使 VM 保持运行(不再删除)。
Azure 本地 VM 管理 Mochostagent 服务可能似乎正在运行,但可能会停滞,而不会更新日志一个多月。 可以通过检查 C:\programdata\mochostagent\logs 中的服务日志来识别此问题,以查看日志是否已更新。 运行以下命令以重启 mochostagent 服务:restart-service mochostagent
Azure 本地虚拟机/Azure Migrate 使用 Azure Migrate 迁移第 1 代(非 sysprep)VM 失败并出现错误:无法从文件系统中清理 VM的种子 ISO 磁盘。 使用 Azure Migrate 迁移第 1 代(非 sysprep)VM 将不再因该错误而失败。
Azure 本地虚拟机/Azure Migrate 由于存储预检查不正确,从 OS 磁盘创建 VM 失败。 无论源是库映像还是 OS 磁盘,VM 创建都成功。
部署 尝试通过 Azure 门户进行部署时,Azure 本地计算机节点在 Azure 门户中不可见。 通过 Azure 门户的 Azure 本地部署仅支持 2503 及更高版本。 对于以前的版本, 请通过 Azure 资源管理器 (ARM) 模板进行部署
部署 在 Azure 本地部署期间,配置代理时,DeviceManagementExtension 无法安装。 使用代理时安装以前的 DeviceManangementExtension 版本 1.2502.0.3012。
更新 从版本 2408.2.7 更新到 2411.0.24 时,更新过程可能会失败并显示以下错误消息: Type 'CauPreRequisites' of Role 'CAU' raised an exception: Could not finish cau prerequisites due to error 'Cannot remove item C:\UpdateDistribution\<any_file_name>: Access to the path is denied.' 此问题现已修复。
更新 确保在验证之前正确复制已导入的 通知 类型的解决方案生成器扩展更新。
更新 改进了 Solution Extension Secret Location cmdlet 帮助,以提供更好的示例。
更新 为群集节点的群集感知更新运行和运行状况检查添加了重试逻辑。
更新 在 .NET 8 更新期间提高了系统稳定性。
更新 使用 2411 版本时,解决方案和解决方案生成器扩展更新不会在单个更新运行中合并。 若要应用解决方案生成器扩展包,需要单独的更新运行。
升级 如果检测到 Carbon PowerShell 模块,请禁用它,然后加载已知模块。
升级 优化了当前的 Carbon PowerShell 模块解决方案。
升级 添加了一个检查,用于验证足够的可用内存来启动 Azure Arc 资源桥 VM。
安全性 已实施安全漏洞 CVE-2024-21302 的缓解措施。 请参阅有关阻止回滚基于虚拟化的安全性 (VBS) 相关安全更新的指南
部署 在通过门户进行 Azure Local 部署期间,“验证选定的计算机”失败,并显示此错误消息:Mandatory extension [Lcm controller] installed version [30.2503.0.907] is not equal to the required version [30.2411.2.789] for Arc machine [Name of the machine]. Please create EdgeDevice resource again for this machine to fix the issue. 重新安装正确的扩展版本 AzureEdgeLifecycleManager 。 请按照下列步骤操作:
1.选择计算机,然后选择 “安装扩展”。

在 Azure Local 计算机上安装扩展的屏幕截图。

2.对要群集的每台计算机重复此步骤。 安装完成大约需要 15 分钟。
3.验证 AzureEdgeLifecycleManager 扩展版本是否为 30.2411.2.789。

可验证的 Azure Local 计算机上安装的扩展版本的屏幕截图。

4. 在列表中的所有计算机上安装扩展后,选择 “添加计算机 ”以刷新列表。
5.选择“ 验证所选计算机”。 验证应成功。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
Azure 本地虚拟机 在某个节点关闭时,无法删除 Arc 启用的 Azure 本地 VM。 如果出现此问题,请联系Microsoft支持部门。
Azure 本地虚拟机 Azure 本地 VM 上的检查点会导致 Azure 本地 VM 与门户之间的同步问题。 删除 VM 上的任何检查点。
更新 对于角色“MocArb”,更新至 2503.0.13 失败 Update PreRequisites,出现异常:SyntaxWarning: invalid escape sequence '\W' at CheckAndInstall-CliExtensions 有关如何解决此问题的详细步骤,请参阅 故障排除指南
安全漏洞 此版本中存在已知安全漏洞,可能会影响更新的安全扫描。 有关详细信息,请参阅 Azure Arc 安装程序漏洞 CVE-2025-26627 - 主机
Azure 本地虚拟机 此版本中存在已知安全漏洞,可能会影响更新的安全扫描。 有关详细信息,请参阅 Azure Arc 安装程序漏洞 CVE-2025-26627 - 来宾
Microsoft Defender for Cloud

Azure 政府
在 Azure 政府云中,Microsoft适用于 Azure 本地的 Defender for Cloud 建议不会显示在 Microsoft Defender for Cloud 门户中。
指标

Azure 政府
Azure 政府云中来自 Azure 本地群集的指标未能发送到 Azure。 因此,指标不会显示在监控、指标或工作簿图表中。 不会触发基于指标的警报,并且无法设置新警报。
升级 由于在安全启动证书安装过程中丢失了 Virtualization-Based 安全(VBS)主密钥,无法升级Get-AzureStackHCI ConnectionStatus中的RepairRegistration群集。 有关如何解决此问题的详细步骤,请参阅 故障排除指南
注册 安装某些更新(包括 BIOS)后,群集可能会报告 RepairRegistrationRequired 并显示过时的连接状态。 有关如何解决此问题的详细步骤,请参阅 故障排除指南

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理旁路列表不会更新 Azure 资源网桥或 AKS 上的代理旁路列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

版本 2411.3 的已知问题

此软件版本对应于软件版本号 2411.3.2

重要

此软件的新部署使用 2411.3.2 版本。 还可以从 2411.2 更新。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中没有修复的问题。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
部署 在通过门户进行 Azure Local 部署期间,“验证选定的计算机”失败,并显示此错误消息:Mandatory extension [Lcm controller] installed version [30.2503.0.907] is not equal to the required version [30.2411.2.789] for Arc machine [Name of the machine]. Please create EdgeDevice resource again for this machine to fix the issue. 重新安装正确的扩展版本 AzureEdgeLifecycleManager 。 请按照下列步骤操作:
1.选择计算机,然后选择 “安装扩展”。

在 Azure Local 计算机上安装扩展的屏幕截图。

2.对要群集的每台计算机重复此步骤。 安装完成大约需要 15 分钟。
3.验证 AzureEdgeLifecycleManager 扩展版本是否为 30.2411.2.789。

可验证的 Azure Local 计算机上安装的扩展版本的屏幕截图。

4. 在列表中的所有计算机上安装扩展后,选择 “添加计算机 ”以刷新列表。
5.选择“ 验证所选计算机”。 验证应成功。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理旁路列表不会更新 Azure 资源网桥或 AKS 上的代理旁路列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

版本 2411.2 的已知问题

此软件版本对应于软件版本号 2411.2.12

重要

此软件的新部署使用 2411.2.12 版本。 还可以从 2411.0 和 2411.1 更新。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 无法使用预下载的 AKS 所需映像删除存储路径。
Azure 本地 VM 管理 节点重启后,映像删除重试失败。 节点关闭并且尝试删除映像时,删除会超时。当节点重启并重试删除时,删除会再次失败。
部署 由于时间戳反序列化的缘故,验证超时。 部署作系统时,选择 英语(美国) 作为安装语言,以及时间和货币格式。
有关详细的修正步骤,请参阅 Azure 本地可支持性 GitHub 存储库中的故障排除指南。
更新 解决方案扩展包无意中应用于解决方案更新。

此版本中的已知问题

此版本中没有已知问题。 后续版本中已修复任何以前已知的问题。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

版本 2411.1 的已知问题

此软件版本对应于软件版本号 2411.1.10

重要

此软件的新部署使用 2411.1.10 版本构建。 如果从 2408.2 更新,你已收到 2411.0.22 或 2411.0.24 内部版本。 这两个版本都可以更新为 2411.1.10。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 重新部署 Azure 本地 VM 会导致与该 Azure 本地 VM 的连接问题,并使代理断开连接。
升级 解决了与第三方 PowerShell 模块的冲突。
升级 已停止无限期记录可忽略的错误事件。
升级 添加了用于检查可用内存的验证。
更新 添加了检查以确保正确复制解决方案扩展内容。
更新 在此版本中应用解决方案更新时,更新可能会失败。 仅当更新在 11 月 26 日之前启动时,才会发生这种情况。 导致失败的问题可能会导致以下错误消息之一:

错误 1 - 步骤“更新 ARB 和扩展”错误“Clear-AzContext 失败,返回 0,使用“1”参数调用“初始化”时出现异常:“对象引用未设置为对象的实例。位于"Clear-AzPowerShellCache"。

错误 2 - 步骤"EvalTVMFlow" 错误 "CloudEngine.Actions.InterfaceInvocationFailedException:角色'ArcIntegration'的类型'EvalTVMFlow'引发异常:此模块需要 Az.Accounts 版本 3.0.5。 Az.Accounts 的早期版本在当前 PowerShell 会话中导入。 请在导入此模块之前打开新会话。 此错误可能表示系统上安装了多个不兼容的 Azure PowerShell cmdlet 版本。 有关故障排除信息,请参阅 https://aka.ms/azps-version-error

根据 PowerShell 模块的版本,可以为版本 3.0.4 和 3.0.5 报告上述错误。
有关如何缓解此问题的详细步骤,请转到:https://aka.ms/azloc-update-30221399
部署
升级
如果在部署 Azure 本地之前时区未设置为 UTC,则验证期间会发生 ArcOperationTimeOut 错误。 将显示以下错误消息:*OperationTimeOut,没有从设备接收用于操作的更新。
安全漏洞 Microsoft发现了一个安全漏洞,该漏洞可能会公开在创建 Azure 本地 VM 期间使用的本地管理员凭据,以便向 VM 和主机上的非管理员用户公开这些凭据。
在 Azure Local 2411 版本之前的版本中运行的 Azure 本地 VM 易受攻击。
修复服务器 修复节点并运行命令 Set-AzureStackLCMUserPassword后,可能会遇到以下错误:

CloudEngine.Actions.InterfaceInvocationFailedException: Type 'ValidateCredentials' of Role 'SecretRotation' raised an exception: Cannot load encryption certificate. The certificate setting 'CN=DscEncryptionCert' does not represent a valid base-64 encoded certificate, nor does it represent a valid certificate by file, directory, thumbprint, or subject name. at Validate-Credentials
此问题现已修复。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

版本 2411 的已知问题

此软件版本对应于软件版本号 2411.0.24

重要

此软件的新部署将使用 2411.0.22 内部版本,而如果你从 2408.2 更新,你将获得 2411.0.24 内部版本。 如果已从 2408.2 更新到 2411.0.22,则无需执行任何作。

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 如果尝试在迁移的 VM 上启用客户机管理,此操作将失败并出现以下错误:(InternalError) 准入 Webhook“createupdatevalidationwebhook.infrastructure.azstackhci.microsoft.com”拒绝请求:创建资源后无法更改 OsProfile
部署 在 Azure 门户中没有检测到以不正确的语法提供 OU 名称。 错误的语法包括不受支持的字符,如 &,",',<,>。 在系统验证过程中的后续步骤中检测到错误的语法。 确保 OU 路径语法正确并且不包含不受支持的字符。
网络连接 当节点配置有其地址中包含大写字母的代理服务器时(例如 HTTPS://10.100.000.00:8080),Arc 扩展将无法在现有内部版本(包括版本 2408.1)的节点上进行安装或更新。 但是,节点保持 Arc 连接。 请执行以下步骤以缓解此错误:

1.以小写形式设置环境值。 [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "https://10.100.000.00:8080", "Machine")

2.验证是否已设置值。 [System.Environment]::GetEnvironmentVariable("HTTPS_PROXY", "Machine").

3.重启 Arc 服务。

Restart-Service himds

Restart-Service ExtensionService

Restart-Service GCArcService

4. 使用小写代理信息向 AzcmaAgent 发出信号。

& 'C:\Program Files\AzureConnectedMachineAgent\azcmagent.exe' config set proxy.url https://10.100.000.00:8080

& 'C:\Program Files\AzureConnectedMachineAgent\azcmagent.exe' config list
升级 将版本从 2311 或更早版本升级到 2408 或更高版本时,添加节点和修复节点操作可能会失败。 例如,可以看到错误:Type 'AddAsZHostToDomain' of Role 'BareMetal' raised an exception
更新 在某些情况下,如果在 SolutionUpdate 命令后运行,则 Send-DiagnosticData 命令可能会失败。 请确保关闭用于 Send-DiagnosticData 的 PowerShell 会话。 打开新的 PowerShell 会话并将其用于 SolutionUpdate 命令。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
Azure Migrate 使用 Azure Migrate 迁移第 1 代(非 sysprep)VM 失败并出现错误:无法从文件系统中清理 VM的种子 ISO 磁盘。 请联系微软技术支持,申请一个解决与此问题关联的虚拟机故障的补丁。
安全漏洞 Microsoft发现了一个安全漏洞,该漏洞可能会向 VM 和主机上的非管理员用户公开在创建 Azure 本地 VM 期间使用的本地管理员凭据。
在 Azure Local 2411 版本之前的版本中运行的 Azure 本地 VM 易受攻击。
若要确定需要此更改的 Azure 本地 VM 并更改帐户密码,请参阅以下详细说明: Azure 本地 VM 的安全漏洞
部署
升级
如果在部署 Azure Local 之前时区未设置为 UTC,则验证期间会发生 ArcOperationTimeOut 错误。 将显示以下错误消息:OperationTimeOut,没有从设备接收用于操作的更新。 根据你的方案,为此问题选择以下解决方法之一:

方案 1. 在开始部署之前,请确保时区设置为 UTC。

连接到每个 Azure 本地节点,并将时区更改为 UTC。

运行以下命令:Set-TimeZone -Id "UTC"

方案 2. 如果在未设置 UTC 时区的情况下启动部署并收到验证阶段中提到的错误,请执行以下步骤:

1.连接到每个 Azure 本地节点。 使用 Set-TimeZone -Id "UTC"将时区更改为 UTC。 重启节点。

2.节点重启后,转到 Azure 门户中的 Azure 本地资源。 再次启动验证以解决问题,并继续部署或升级。

有关详细的修正步骤,请参阅 Azure 本地可支持性 GitHub 存储库中的故障排除指南。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

版本 2408.2 的已知问题

此软件发行版本对应的软件版本号是 2408.2.7

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
安全性 SideChannelMitigation 在本地 cmdlet 和 Windows 管理中心内均正常报告。
更新 更新会不必要地下载已添加的解决方案生成器扩展内容。
升级 群集资源不在同一组中。
升级 修复了 Azure 门户中的 IP 池验证。
升级 添加了验证以确保包是最新版本
升级 由于组策略,验证将失败。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
安全性 修复最小密码长度规则的符合性时,即使将 Azure 本地主机上的最小密码长度更改为 14,仍会在 Azure 策略中将其视为不合规。 可以使用 net accounts cmdlet 验证密码的长度。 在输出中,找到 “最小密码长度 ”以查看该值。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 本地 VM 管理 如果尝试在迁移的 VM 上启用来宾管理,此操作将失败并出现以下错误:(InternalError) 准入 Webhook“createupdatevalidationwebhook.infrastructure.azstackhci.microsoft.com”已拒绝请求:创建资源后无法更改 OsProfile
安全性 即使已启用 SideChannelMitigation 安全功能,也可能不会显示启用状态。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 请确保不要在 Azure 本地部署的逻辑网络的名称中使用下划线。
添加节点 在此版本和以前的版本中,将节点添加到群集时,无法更新代理绕过列表字符串以包含新节点。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口

版本 2408.1 的已知问题

此软件版本对应于软件版本号 2408.1.9

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 如果客户在创建时未传递 mac 地址,则 VM 网络接口的 MAC 地址不会显示。
部署 某些情况下,在注册 Azure Stack HCI 服务器期间,可能会在调试日志中看到以下错误:遇到了内部服务器错误。 可能没有安装用于设备部署的必需扩展插件之一。 请执行以下步骤以缓解此错误:

$Settings = @{ "CloudName" = $Cloud; "RegionName" = $Region; "DeviceType" = "AzureEdge" }

New-AzConnectedMachineExtension -Name "AzureEdgeTelemetryAndDiagnostics" -ResourceGroupName $ResourceGroup -MachineName $env:COMPUTERNAME -Location $Region -Publisher "Microsoft.AzureStack.Observability" -Settings $Settings -ExtensionType "TelemetryAndDiagnostics" -EnableAutomaticUpgrade

New-AzConnectedMachineExtension -Name "AzureEdgeDeviceManagement" -ResourceGroupName $ResourceGroup -MachineName $env:COMPUTERNAME -Location $Region -Publisher "Microsoft.Edge" -ExtensionType "DeviceManagementExtension"

New-AzConnectedMachineExtension -Name "AzureEdgeLifecycleManager" -ResourceGroupName $ResourceGroup -MachineName $env:COMPUTERNAME -Location $Region -Publisher "Microsoft.AzureStack.Orchestration" -ExtensionType "LcmController"

New-AzConnectedMachineExtension -Name "AzureEdgeRemoteSupport" -ResourceGroupName $ResourceGroup -MachineName $env:COMPUTERNAME -Location $Region -Publisher "Microsoft.AzureStack.Observability" -ExtensionType "EdgeRemoteSupport" -EnableAutomaticUpgrade
网络连接 当 Azure 本地计算机关闭时,新门户体验中的“所有群集”页会显示“PartiallyConnected”或“最近未连接 ”状态。 即使 Azure 本地计算机正常运行,它们可能不会显示“已连接”状态。 此问题没有已知的解决方法。 若要检查连接状态,请使用旧体验来查看它是否显示为“Connected”。
更新 MOC 节点代理会在更新 MOC 步骤期间停滞于待重启阶段。
更新 升级时未授予所需的权限,导致更新后来失败。
升级 添加了用于检查 IPv6 地址的验证。
更新 如果系统中的主机名是另一个主机名的子集,则 SBE 接口不会在所有计算机上执行。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 本地 VM 管理 如果尝试在迁移的 VM 上启用客户机管理,此操作将失败并出现以下错误:(InternalError) 准入 Webhook“createupdatevalidationwebhook.infrastructure.azstackhci.microsoft.com”拒绝请求:创建资源后无法更改 OsProfile
安全性 即使已启用 SideChannelMitigation 安全功能,也可能不会显示启用状态。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
添加服务器 在此版本和以前的版本中,将计算机添加到系统时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口

版本 2408 的已知问题

此软件发布对应于软件版本号 2408.0.29

此版本的发行说明包括此版本中已修复的问题、此版本中的已知问题以及旧版本中的发行说明问题。

注释

有关常见已知问题的详细修正,请参阅 Azure 本地可支持性 GitHub 存储库。

修复的问题

此版本中已修复以下问题:

功能 / 特点 问题 变通方法/注释
更新 修复了与运行状况检查中缺少资源类型 ID 字段相关的更新问题。
更新 修复了与具有相同名称的不同健康检查相关的更新问题。
Azure 本地 VM 管理 在大规模部署场景中,例如大规模 AVD 主机池部署或大规模 VM 配置,您可能会遇到由 Hyper-V 套接字外部库问题引起的可靠性问题。
部署 通过 Azure 资源管理器进行的部署在 2 小时后超时。 尽管已成功创建系统,但超过 2 小时的部署在资源组中显示为失败。 若要在 Azure 门户中监视部署,请转到 Azure 本地实例资源,然后转到新的 部署 条目。

此版本中的已知问题

下表列出了此版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 本地 VM 管理 如果尝试在迁移的 VM 上启用客户机管理,此操作将失败并出现以下错误:(InternalError) 准入 Webhook“createupdatevalidationwebhook.infrastructure.azstackhci.microsoft.com”拒绝请求:创建资源后无法更改 OsProfile
安全性 即使已启用 SideChannelMitigation 安全功能,也可能不会显示启用状态。 使用 Windows Admin Center(群集安全视图)或此 cmdlet 返回 FalseGet-AzSSecurity -FeatureName SideChannelMitigation 时,会发生这种情况。 此版本中没有解决方法来修复这些应用程序的输出。
若要验证预期值,请运行以下 cmdlet:
Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management' -name "FeatureSettingsOverride*"
预期输出为:
FeatureSettingsOverride:83886152
FeatureSettingsOverrideMask:3
如果输出与预期的输出匹配,则可以安全地忽略 Windows Admin Center 和 Get-AzSSecurity cmdlet 的输出。
更新 为 Azure 本地系统安装 SBE 更新时,如果群集中的主机名是另一个主机名的子集,则不会在所有计算机上执行某些 SBE 接口。 例如,host-1 是 host-10 的子集。 这可能会导致 CAU 扫描或 CAU 运行失败。 Microsoft建议在主机命名约定中使用至少 2 位数的主机名实例计数。 有关详细信息,请参阅定义命名约定

以前版本中的已知问题

下表列出了以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure 本地实例的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 请确保不要在 Azure 本地实例上部署的逻辑网络的名称中使用下划线。
添加服务器 在此版本和以前的版本中,将计算机添加到群集时,无法更新代理绕过列表字符串以包含新计算机。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口

版本 2405.3 的问题

此软件版本对应于软件版本号 2405.3.7

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
更新 在此版本中,修复了主机完成机密轮换和更新后 SDN 无法工作的更新问题。
更新 在此版本中,修复了与物理磁盘环境就绪情况检查错误失败和阻止更新相关的更新问题
部署 在此版本中,修复了与云部署中的空值相关的部署操作。
更新 在此版本中,修复了用于防止摘要 XML 错误的运行状况检查更新。
Azure 本地 VM 管理 Azure 本地 VM 上的 Arc 扩展会无限期保持“创建”状态。 登录到 VM,打开命令提示符,然后键入以下内容:
Windows
notepad C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json
Linux
sudo vi /var/opt/azcmagent/agentconfig.json
接下来,查找 resourcename 属性。 删除追加到资源名称末尾的 GUID,以使该属性与 VM 的名称匹配。 然后,重启 VM。
Azure 本地 VM 管理 Azure 本地 VM 操作的重启大约在 20 分钟后完成,尽管 VM 本身在大约一分钟内重新启动。 此版本中没有已知的解决方法。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure Stack HCI 群集的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
Azure 本地 VM 管理 在大规模部署场景中,例如大规模 AVD 主机池部署或大规模 VM 配置,您可能会遇到由 Hyper-V 套接字外部库问题引起的可靠性问题。 请执行以下步骤以缓解此错误:
1. 运行命令 Get-service mochostagent (\) get-process (\) kill。 检查命令的输出,并验证句柄计数是否达到了数以千计。

2. 运行命令 Get-service mochostagent (\) get-process 以终止进程。

3. 运行 restart-service mochostagent 命令以重启 mochostagent 服务。
部署 通过 Azure 门户部署 Azure 本地时,可能会遇到以下部署验证失败:

Could not complete the operation. 400: Resource creation validation failed. Details: [{"Code":"AnswerFileValidationFailed","Message":"Errors in Value Validation:\r\nPhysicalNodesValidator found error at deploymentdata.physicalnodes[0].ipv4address: The specified for \u0027deploymentdata.physicalnodes[0].ipv4address\u0027 is not a valid IPv4 address. Example: 192.168.0.1 or 192.168.0.1","Target":null,"Details":null}].

如果转到 Azure 门户部署中的 “网络 ”选项卡,在 “网络意向 ”配置中,可能会看到以下错误:所选物理网络适配器未绑定到管理虚拟交换机。
请按照 Azure 门户的部署验证失败问题排查过程进行操作。
部署 通过 Azure 门户进行的部署失败,并出现此错误:无法从密钥保管库提取机密 LocalAdminCredential 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
添加服务器 在此版本和以前的版本中,将服务器添加到群集时,无法更新代理旁路列表字符串来包含新服务器。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2405.2 的问题

此软件版本对应于软件版本号 2405.2.7

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
更新 在此版本中,修复了与运行状况检查中缺少资源类型 ID 字段相关的更新问题。
更新 在此版本中,修复了与不同健康检查具有相同名称相关的更新问题。
更新 在此版本中,修复了解决方案生成器扩展更新健康检查在更新前或每日健康检查中缺失的问题。
更新 在此版本中,修复了由于更新服务在处于错误状态的服务器上崩溃而导致无法查看或启动新更新的问题。
更新 在此版本中,更新服务已得到改进,以防止群集上操作泛滥。
更新 在此版本中,添加了运行状况检查以防止在添加或删除服务器失败时进行更新。
更新 在初始 MOC 更新期间,由于未在目录缓存中找到目标 MOC 版本,因此导致失败。 后续更新和重试将在目标版本中显示 MOC,但更新不成功,因此 Azure Arc 资源网桥更新失败。

若要验证此问题,请使用排查 Azure Local 解决方案更新问题收集更新日志。 日志文件应显示一条类似的错误消息(当前版本的错误消息可能有所不同):

[ERROR: { "errorCode": "InvalidEntityError", "errorResponse": "{\n\"message\": \"the cloud fabric (MOC) is currently at version v0.13.1. A minimum version of 0.15.0 is required for compatibility\"\n}" }]
请执行以下步骤以缓解此错误:

1. 要查找 MOC 代理版本,请运行以下命令:'C:\Program Files\AksHci\wssdcloudagent.exe' version

2. 使用命令的输出从下表中查找与代理版本匹配的 MOC 版本,并将 $initialMocVersion 设置为该 MOC 版本。 要设置 $targetMocVersion,请先查找您要更新的 Azure 本地构建版本,然后从下表中获取相应的 MOC 版本。 在下面提供的缓解脚本中使用这些值:

构建MOC 版本代理版本
2311.21.0.24.10106v0.13.0-6-gf13a73f7、v0.11.0-alpha.38,01/06/2024
24021.0.25.10203v0.14.0、v0.13.1、02/02/2024
2402.11.0.25.10302v0.14.0、v0.13.1、03/02/2024
2402.21.1.1.10314v0.16.0-1-g04bf0dec、v0.15.1、03/14/2024
2405/2402.31.3.0.10418v0.17.1、v0.16.5、04/18/2024


例如,如果代理版本为 v0.13.0-6-gf13a73f7、v0.11.0-alpha.38、01/06/2024,则 $initialMocVersion = "1.0.24.10106";如果要更新到 2405.0.23,则 $targetMocVersion = "1.3.0.10418"

3. 在第一个节点上运行以下 PowerShell 命令:

$initialMocVersion = "<initial version determined from step 2>"
$targetMocVersion = "<target version determined from step 2>"

# 导入 MOC 模块两次
import-module moc
import-module moc
$verbosePreference = "Continue"

# 清除 SFS 目录缓存
Remove-Item (Get-MocConfig).manifestCache

# 在更新之前将版本设置为当前 MOC 版本,并将状态设置为更新失败
Set-MocConfigValue -name "version" -value $initialMocVersion
Set-MocConfigValue -name "installState" -value ([InstallState]::UpdateFailed)

# 重新运行 MOC 更新以升级到所需版本
Update-Moc -version $targetMocVersion

4. 恢复更新。
Azure 本地 VM 管理 在早期版本中,VM 的任何电源状态更改操作(如启动、停止、保存和暂停)最初都会将 VM 的状态返回为正在运行,并在刷新 30+ 秒后最终显示正确的状态。 在此版本中,电源状态更改操作仅在 VM 状态更改为预期状态后返回。

此版本中的已知问题

功能 / 特点 问题 解决方法
更新 由于 SDN 基础结构 VM 中存在 bug,因此在主机完成机密轮换和更新后,SDN 将停止工作。 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 由于环境就绪检查器中存在错误,物理磁盘环境就绪检查错误失败并阻止更新。 等待几分钟,并重试更新。
部署 在此版本中,您可能会收到以下错误:调用云部署失败 - 值不能为空 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 在此版本中,环境检查失败并出现以下错误:更新处于失败状态:HealthCheckFailed。ECE 中的摘要 XML 不存在 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure Stack HCI 群集的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
Azure 本地 VM 管理 在大规模部署场景中,例如大规模 AVD 主机池部署或大规模 VM 配置,您可能会遇到由 Hyper-V 套接字外部库问题引起的可靠性问题。 请执行以下步骤以缓解此错误:
1. 运行命令 Get-service mochostagent (\) get-process (\) kill。 检查命令的输出,并验证句柄计数是否达到了数以千计。

2. 运行命令 Get-service mochostagent (\) get-process 以终止进程。

3. 运行 restart-service mochostagent 命令以重启 mochostagent 服务。
部署 通过 Azure 门户部署 Azure 本地时,可能会遇到以下部署验证失败:

Could not complete the operation. 400: Resource creation validation failed. Details: [{"Code":"AnswerFileValidationFailed","Message":"Errors in Value Validation:\r\nPhysicalNodesValidator found error at deploymentdata.physicalnodes[0].ipv4address: The specified for \u0027deploymentdata.physicalnodes[0].ipv4address\u0027 is not a valid IPv4 address. Example: 192.168.0.1 or 192.168.0.1","Target":null,"Details":null}].

如果转到 Azure 门户部署中的 “网络 ”选项卡,在 “网络意向 ”配置中,可能会看到以下错误:所选物理网络适配器未绑定到管理虚拟交换机。
请按照 Azure 门户的部署验证失败问题排查过程进行操作。
部署 通过 Azure 门户进行的部署失败,并出现此错误:无法从密钥保管库提取机密 LocalAdminCredential 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
添加服务器 在此版本和以前的版本中,将服务器添加到群集时,无法更新代理旁路列表字符串来包含新服务器。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2405.1 的问题

此软件发布与软件版本号 2405.1.4对应。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
更新 修复了更新问题。 此问题导致在群集感知更新 (CAU) 步骤后更新失败,尽管在这种情况下重新运行 CAU 可以解决该问题。
可观察性 在此版本中,修复了导致安装扩展后默认禁用主动日志收集的问题。
更新 修复了代理生命周期管理器 (ALM) 在机密轮换后无法重新启动服务的问题。
更新 在此版本中,修复了使用 PowerShell 命令 Start-SolutionUpdate 重试失败的解决方案更新时出现的错误。
更新 修复了导致解决方案生成器扩展更新无法下载的问题。
更新 修复了以下问题:在基于部署服务主体名称 (SPN) 设置进行 SPN 验证期间,更新会失败。
更新 修复了以下问题:Azure Arc 资源网桥(ARB)的更新需要很长时间,并且更新失败。
更新 修复了以下问题:在预更新或每日运行状况检查中,缺少解决方案生成器更新的运行状况检查。
添加服务器
修复服务器
Add-Server期间,集群存储网络不应期望与存储 VLAN ID 相同。
网络 AzStackHci_Network_Test_Infra_IP_Connection 需要遵循终结点定义的严重性。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
更新 通过 Azure 更新管理器查看 Azure Stack HCI 群集的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
Azure 本地 VM 管理 在大规模部署场景中,例如大规模 AVD 主机池部署或大规模 VM 配置,您可能会遇到由 Hyper-V 套接字外部库问题引起的可靠性问题。 请执行以下步骤以缓解此错误:
1. 运行命令 Get-service mochostagent (\) get-process (\) kill。 检查命令的输出,并验证句柄计数是否达到了数以千计。

2. 运行命令 Get-service mochostagent (\) get-process 以终止进程。

3. 运行 restart-service mochostagent 命令以重启 mochostagent 服务。
部署 通过 Azure 门户部署 Azure 本地时,可能会遇到以下部署验证失败:

Could not complete the operation. 400: Resource creation validation failed. Details: [{"Code":"AnswerFileValidationFailed","Message":"Errors in Value Validation:\r\nPhysicalNodesValidator found error at deploymentdata.physicalnodes[0].ipv4address: The specified for \u0027deploymentdata.physicalnodes[0].ipv4address\u0027 is not a valid IPv4 address. Example: 192.168.0.1 or 192.168.0.1","Target":null,"Details":null}].

如果转到 Azure 门户部署中的 “网络 ”选项卡,在 “网络意向 ”配置中,可能会看到以下错误:所选物理网络适配器未绑定到管理虚拟交换机。
请按照 Azure 门户的部署验证失败问题排查过程进行操作。
部署 通过 Azure 门户进行的部署失败,并出现此错误:无法从密钥保管库提取机密 LocalAdminCredential 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
添加服务器 在此版本和以前的版本中,将服务器添加到群集时,无法更新代理旁路列表字符串来包含新服务器。 更新主机上的环境变量代理绕过列表不会更新 Azure Arc 资源网桥或 AKS 上的代理绕过列表。 此版本中没有解决方法。 如果遇到此问题,请联系 Microsoft 支持部门以确定后续步骤。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2405 的问题

此软件版本对应于软件版本号 2405.0.24

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Active Directory 在使用大型 Active Directory 的群集部署期间,修复了将用户添加到本地管理员组时可能导致超时的问题。
部署 新的 ARM 模板已发布,用于创建群集,从而简化依赖项资源创建。 这些模板包含了一些修复措施,解决了必填字段缺失的问题。
部署 机密轮换 PowerShell 命令 Set-AzureStackLCMUserPassword 支持一个新参数来跳过确认消息。
部署 改进了当服务未及时重启时密钥轮换的可靠性。
部署 修复了一个问题,即在使用不相交的命名空间时启用部署。
SBE 发布了一个新的 PowerShell 命令,可用于更新部署时提供的 SBE 合作伙伴属性值。
SBE 修复了阻止更新服务在仅运行 SBE 更新后响应请求的问题。
添加服务器
修复服务器
修复了阻止节点在添加服务器操作期间加入 Active Directory 的问题。
修复服务器 极少数情况下,Repair-Server 操作会失败,并且会出现 HealthServiceWaitForDriveFW 错误。 在这些情况下,不会移除已修复节点中的旧驱动器,并且新磁盘会停滞在维护模式下。
修复服务器 将单服务器 Azure Stack HCI 从 2311 更新到 2402,然后执行 Repair-Server 时,会出现此问题。 修复操作失败。
网络 在使用某些网络适配器类型设置主机网络配置时,提高了网络 ATC 的可靠性。
网络 改进了检测磁盘驱动器固件版本时的可靠性。
更新 改进了将设备运行状况检查结果的更新通知发送到 AUM(Azure 更新管理器)的可靠性。 在某些情况下,消息大小可能太大,导致 AUM 中未显示任何结果。
更新 修复了可能导致受信任启动 VM 代理(IGVM)更新失败的文件锁定问题。
更新 修复了在更新运行期间阻止业务流程协调程序代理重启的问题。
更新 修复了更新服务发现或启动更新所花费的时间较长的罕见情况。
更新 修复了当 CAU 报告正在进行的更新时,群集感知更新 (CAU) 与业务流程协调程序交互的问题。
更新 已调整更新的命名架构,以允许识别功能与累积更新。
更新 改进了向业务流程协调程序报告群集更新进度的可靠性。
Azure Arc 解决了混合实例元数据服务(HIMDS)重启时 Azure Arc 连接丢失的问题,中断了 Azure 门户功能。 设备现在会自动在这些情况下恢复 Azure Arc 连接。
更新 尝试安装解决方案更新可能会在 CAU 步骤结束时失败,原因如下:
There was a failure in a Common Information Model (CIM) operation, that is, an operation performed by software that Cluster-Aware Updating depends on.
如果节点重启后 Cluster NameCluster IP Address 资源无法启动,则会出现这种罕见的问题,这在小型群集中最为常见。
此问题现已修复。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 在大规模部署场景中,例如大规模 AVD 主机池部署或大规模 VM 配置,您可能会遇到由 Hyper-V 套接字外部库问题引起的可靠性问题。 请执行以下步骤以缓解此错误:
1. 运行命令 Get-service mochostagent (\) get-process (\) kill。 检查命令的输出,并验证句柄计数是否达到了数以千计。

2. 运行命令 Get-service mochostagent (\) get-process 以终止进程。

3. 运行 restart-service mochostagent 命令以重启 mochostagent 服务。
部署 通过 Azure 门户部署 Azure 本地时,可能会遇到以下部署验证失败:

Could not complete the operation. 400: Resource creation validation failed. Details: [{"Code":"AnswerFileValidationFailed","Message":"Errors in Value Validation:\r\nPhysicalNodesValidator found error at deploymentdata.physicalnodes[0].ipv4address: The specified for \u0027deploymentdata.physicalnodes[0].ipv4address\u0027 is not a valid IPv4 address. Example: 192.168.0.1 or 192.168.0.1","Target":null,"Details":null}].

如果转到 Azure 门户部署中的 “网络 ”选项卡,在 “网络意向 ”配置中,可能会看到以下错误:所选物理网络适配器未绑定到管理虚拟交换机。
请按照 Azure 门户的部署验证失败问题排查过程进行操作。
部署 通过 Azure 门户进行的部署失败,并出现此错误:无法从密钥保管库提取机密 LocalAdminCredential 此版本中没有此问题的解决方法。 如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
部署 由于某些硬件配置的兼容性问题,Azure Stack HCI 版本 23H2 操作系统的新 ISO 映像已回滚到之前的版本。 如果在 Arc 注册中遇到任何问题,请回滚到以前的版本。 如果已成功部署较新的映像,则无需执行任何操作。 这两个 ISO 映像的操作系统构建版本是相同的。
更新 通过 Azure 更新管理器查看 Azure Stack HCI 群集的就绪情况检查结果时,可能有多个具有相同名称的就绪情况检查。 此版本中没有已知的解决方法。 选择查看详细信息,以查看有关准备情况检查的特定信息。
更新 此版本中存在间歇性问题,即使更新已成功完成,Azure 门户也可能错误地将更新状态显示为 “无法更新 ”或“ 正在进行”。 通过 Azure 更新管理器更新 Azure 本地实例时,尤其观察到此行为,其中更新进度和结果在门户中可能不可见。 可能需要等待最多 30 分钟或更多时间才能查看更新的状态。 如果状态在该时间过后仍未刷新,请执行以下步骤:通过远程 PowerShell 会话 连接到 Azure 本地实例 。 要确认更新状态,请运行以下 PowerShell cmdlet:

$Update = get-solutionupdate| ? version -eq "<version string>"

将版本字符串替换为正在运行的版本。 例如 "10.2405.0.23"。

$Update.state

如果更新状态为 已安装,您无需采取进一步操作。 Azure 门户网站在 24 小时内会准确地刷新状态。
若要更快地刷新状态,请在其中一个节点上执行以下步骤。
重启云管理群集组。
Stop-ClusterGroup "Cloud Management"
Start-ClusterGroup "Cloud Management"
安全性 即使已启用 SideChannelMitigation 安全功能,也可能不会显示启用状态。 使用 Windows Admin Center(群集安全视图)或此 cmdlet 返回 FalseGet-AzSSecurity -FeatureName SideChannelMitigation 时,会发生这种情况。 此版本中没有解决方法来修复这些应用程序的输出。
若要验证预期值,请运行以下 cmdlet:
Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management' -name "FeatureSettingsOverride*"
预期输出为:
FeatureSettingsOverride:83886152
FeatureSettingsOverrideMask:3
如果输出与预期的输出匹配,则可以安全地忽略 Windows Admin Center 和 Get-AzSSecurity cmdlet 的输出。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2402.4 的问题

此软件版本对应于软件版本号 2402.4.4

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 变通方法/注释
网络连接 使用代理服务器时环境检查失败。 根据设计,winhttp 和 wininet 的旁路列表不同,这会导致验证检查失败。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2402.3 的问题

此软件版本对应于软件版本号 2402.3.10

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 变通方法/注释
更新 将群集更新应用到 10.2311.5.6 时,Get-SolutionUpdate cmdlet 可能无法响应,最终在大约 10 分钟后失败并出现 RequestTimeoutException。 在添加或修复服务器方案后,可能会发生这种情况。 此问题现已修复。

此版本中的已知问题

Microsoft 在此版本中未发现任何已知问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 确保不要在 Azure Stack HCI 上部署的逻辑网络的名称中使用下划线。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。

版本 2402.2 的问题

此软件版本对应于软件版本号 2402.2.12

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

Microsoft 在此版本中未发现任何已解决的问题。

此版本中的已知问题

此版本中没有已知问题。 后续版本中已修复任何以前已知的问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 请确保不要在 Azure 本地部署的逻辑网络的名称中使用下划线。
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口

版本 2402.1 的问题

此软件版本对应软件版本号 10.2402.1.5

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 变通方法/注释
更新 在此版本中,由于运行状况检查问题,导致无法通过 Azure 门户更新单个 Azure 本地服务器。 通过 PowerShell 更新 Azure Local
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
Azure 本地 VM 管理 如果用于在 Azure 本地环境中部署 Azure 虚拟机的资源组名称中包含下划线,则来宾代理安装将失败。 因此,您将无法启用访客管理。 请确保用于部署 Azure 本地虚拟机 的资源组中没有下划线。
部署 如果您自行准备 Active Directory(不使用 Microsoft 提供的脚本和步骤),由于缺少 Generic All 权限,您的 Active Directory 验证可能会失败。 这是因为验证检查时出现问题,导致无法查找 msFVE-RecoverInformationobjects – General – Permissions Full control 的专用权限条目,而这是 BitLocker 恢复所必需的。 此问题现已修复。
部署 在此版本中有一个罕见的问题,即在 Azure 的本地部署期间会删除 DNS 记录。 发生这种情况时,会出现以下异常:
Type 'PropagatePublicRootCertificate' of Role 'ASCA' raised an exception:<br>The operation on computer 'ASB88RQ22U09' failed: WinRM cannot process the request. The following error occurred while using Kerberos authentication: Cannot find the computer ASB88RQ22U09.local. Verify that the computer exists on the network and that the name provided is spelled correctly at PropagatePublicRootCertificate, C:\NugetStore\Microsoft.AzureStack, at Orchestration.Roles.CertificateAuthority.10.2402.0.14\content\Classes\ASCA\ASCA.psm1: line 38, at C:\CloudDeployment\ECEngine\InvokeInterfaceInternal.psm1: line 127,at Invoke-EceInterfaceInternal, C:\CloudDeployment\ECEngine\InvokeInterfaceInternal.psm1: line 123.
此问题现已修复。
添加/修复服务器 在此版本中,添加或修复服务器时,从现有节点复制软件负载均衡器或网络控制器 VM 证书时,会出现故障。 失败的原因是部署/更新期间未生成这些证书。 此问题现已修复。
部署 在此版本中,存在一个暂时性问题,导致部署失败,但以下情况除外:
Type 'SyncDiagnosticLevel' of Role 'ObservabilityConfig' raised an exception:*<br>*Syncing Diagnostic Level failed with error: The Diagnostic Level does not match. Portal was not set to Enhanced, instead is Basic.
此问题现已修复。
更新 在极少数情况下,如果失败的更新在 Azure 更新管理器中停留在正在进行状态,则会禁用 重试按钮。 此问题现已修复。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
HCI 上的 AKS AKS 群集创建失败,出现 Error: Invalid AKS network resource id。 当关联的逻辑网络名称具有下划线时,可能会出现此问题。 逻辑网络名称不支持下划线。 请确保不要在 Azure 本地部署的逻辑网络的名称中使用下划线。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口

版本 2402 的问题

此软件发布对应于软件版本号 10.2402.0.23

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 变通方法/注释
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误: Validator failed. Can't retrieve the dynamic parameters for the cmdlet. PowerShell Gallery is currently unavailable. Please try again later. 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 此问题在此版本中已修复。 扩展自动得到修正并达到成功的部署状态。
更新 尝试使用命令更改 AzureStackLCMUserPassword 时,可能会遇到此错误: Set-AzureStackLCMUserPassword

Can't find an object with identity: 'object id'*.
此版本中没有已知的解决方法。
安全性 对于新部署,具有安全核心功能的设备在默认情况下不会启用动态信任根 (DRTM)。 如果尝试使用 Enable-AzSSecurity cmdlet 启用 (DRTM),则会出现当前版本不支持 DRTM 设置的错误。
Microsoft 建议进行深层防御,UEFI 安全启动仍然通过确保仅在签名和验证时加载静态信任根 (SRT) 引导链中的组件来保护这些组件。
网络连接 此版本中存在偶发的 DNS 客户端问题,导致部署过程在两节点群集上失败,并出现 DNS 解析错误:发送 RestRequest 时发生 WebException。WebException.Status:NameResolutionFailure。 由于这个错误,第二个节点的 DNS 记录在创建后不久被删除,从而导致 DNS 错误。 此问题现已修复。
群集感知更新 节点恢复操作失败,无法恢复节点。 此问题现已修复。
群集感知更新 挂起节点操作被卡住超过 90 分钟。 此问题现已修复。
更新 在极少数情况下,当应用从 2311.0.24 到 2311.2.4 的更新时,群集状态显示正在进行,而不是预期的无法更新 此问题现已修复。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
部署 如果您自行准备 Active Directory(不使用 Microsoft 提供的脚本和步骤),由于缺少 Generic All 权限,您的 Active Directory 验证可能会失败。 这是因为验证检查时出现问题,导致无法查找 msFVE-RecoverInformationobjects – General – Permissions Full control 的专用权限条目,而这是 BitLocker 恢复所必需的。 使用准备 AD 脚本方法,或者如果使用自己的方法,请确保分配特定权限 msFVE-RecoverInformationobjects – General – Permissions Full control
部署 在此版本中,多节点部署发生远程任务失败,导致出现以下异常:
ECE RemoteTask orchestration failure with ASRR1N42R01U31 (node pingable - True): A WebException occurred while sending a RestRequest. WebException.Status: ConnectFailure on [https://<URL>](https://<URL>).
缓解措施是在受影响的节点上重新启动 ECE 代理。 在服务器上,打开 PowerShell 会话并运行以下命令:
Restart-Service ECEAgent
更新 在此版本中,存在运行状况检查问题,而它会导致无法通过 Azure 门户更新单个服务器的 Azure Stack HCI。 通过 PowerShell 更新 Azure Stack HCI。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
更新 通过 Azure 更新管理器更新 Azure Stack HCI 群集时,更新进度和结果可能在 Azure 门户中不可见。 要解决此问题,请在每个群集节点上添加以下注册表项(无需值):

New-Item -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HciCloudManagementSvc\Parameters" -force

然后在其中一个群集节点上重启云管理群集组。

Stop-ClusterGroup "Cloud Management"

Start-ClusterGroup "Cloud Management"

这不会完全修正问题,因为进度详细信息在更新过程期间可能仍未显示。 要获取最新的更新详细信息,您可以使用 PowerShell检索更新进度。
更新 在此版本中,如果在实际应用 2311.2 更新之前运行 Test-CauRun 该 cmdlet,则会看到有关缺少防火墙规则的错误消息,用于远程关闭 Azure Stack HCI 系统。 在应用 2311.2 更新时,缺失的规则会自动创建,因此您无需执行任何操作。

应用将来的更新时,请确保运行 Get-SolutionUpdateEnvironment cmdlet 而不是 Test-CauRun
Azure 本地 VM 管理 如果用于在 Azure Stack HCI 上部署 Azure 本地 VM 的资源组名称中具有下划线,则来宾代理安装会失败。 因此,您将无法启用访客管理。 请确保用于部署 Azure 本地虚拟机 的资源组中没有下划线。

版本 2311.5 的问题

此软件版本对应于软件版本号 10.2311.5.6。 此版本仅支持 2311 版本中的更新。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 在某些情况下,逻辑网络的状态在 Azure 门户中显示为“失败”。 这是由于尝试删除逻辑网络时,没有先删除与该逻辑网络关联的网络接口等资源。
你仍应该能够在此逻辑网络上创建资源。 此实例中的状态具有误导性。
此问题现已修复。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
更新 下载操作在指定的 6 小时超时后不会终止。 Microsoft正在积极解决此问题。 如果遇到此问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 更新处于失败状态:DownloadFailed。 ECE 中的摘要 XML 不存在。 Microsoft正在积极解决此问题。 如果遇到此问题,请联系 Microsoft 支持部门以执行后续步骤。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 将新节点添加到群集中时,操作失败并出现错误:节点添加失败,在群集上安装了旧版 Azure Local VM 群集扩展。 请确保端口 443 上具有最新的防火墙配置要求,包括端点 https://hciarcvmscontainerregistry.azurecr.io。 Azure 本地 VM 容器注册表需要此终结点。
Azure 本地 VM 管理 更新到 10.2311.4.5 时,arcbridge 状态在 Azure 门户中显示“UpgradeFailed”。 请确保端口 443 上具有最新的防火墙配置要求,包括端点 https://hciarcvmscontainerregistry.azurecr.io。 Azure 本地 VM 容器注册表需要此终结点。
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误: Validator failed. Can't retrieve the dynamic parameters for the cmdlet. PowerShell Gallery is currently unavailable. Please try again later. 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 AzureEdgeRemoteSupport 扩展在群集视图中显示为“失败”,而在节点视图中显示为“成功”。 此外,节点视图还显示不正确的扩展名称“AzureEdgeRemoteSupport”。 此问题是外观上的,不会影响扩展功能。 可能需要按照以下步骤手动缓解此问题:

1. 在 Azure 门户中,导航到节点的资源组。

2.转到每个 Arc 节点并卸载远程支持扩展。

3. 请允许最多 12 小时让 Azure 本地资源提供程序更新扩展。

此过程允许重新安装扩展,确保它显示正确的名称 AzureEdgeRemoteSupport,并解决群集视图中观察到的任何故障。

(可选)可以使用 cmdlet sync-azurestackhci 在任何群集节点上强制同步。
更新 在此版本中,由于运行状况检查问题,导致运行 Azure Local 的单个服务器无法通过 Azure 门户进行更新。 使用 PowerShell 执行更新。 有关详细信息,请参阅通过 PowerShell 更新 Azure Local
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 解决方法是再次运行脚本,并确保在通过 Azure 门户 部署之前安装所有必需的扩展。
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。

版本 2311.4 的问题

此软件版本对应于软件版本号 10.2311.4.6。 此版本仅支持 2311 版本中的更新。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

以下是此版本中的已修复问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
Azure 本地 VM 管理 如果用于在 Azure 本地环境中部署 Azure 虚拟机的资源组名称中包含下划线,则来宾代理安装将失败。 因此,您将无法启用访客管理。 请确保用于部署 Azure 本地虚拟机 的资源组中没有下划线。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
Azure 本地 VM 管理 将新节点添加到群集中时,操作失败并出现错误:节点添加失败,在群集上安装了旧版 Azure Local VM 群集扩展。 请确保端口 443 上具有最新的防火墙配置要求,包括端点 https://hciarcvmscontainerregistry.azurecr.io。 Azure 本地 VM 容器注册表需要此终结点。
Azure 本地 VM 管理 更新到 10.2311.4.5 时,arcbridge 状态在 Azure 门户中显示“UpgradeFailed”。 请确保端口 443 上具有最新的防火墙配置要求,包括端点 https://hciarcvmscontainerregistry.azurecr.io。 Azure 本地 VM 容器注册表需要此终结点。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 变通方法/注释
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误: Validator failed. Can't retrieve the dynamic parameters for the cmdlet. PowerShell Gallery is currently unavailable. Please try again later. 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 AzureEdgeRemoteSupport 扩展在群集视图中显示为“失败”,而在节点视图中显示为“成功”。 此外,节点视图还显示不正确的扩展名称“AzureEdgeRemoteSupport”。 此问题是外观上的,不会影响扩展功能。 可能需要按照以下步骤手动缓解此问题:

1. 在 Azure 门户中,导航到节点的资源组。

2.转到每个 Arc 节点并卸载远程支持扩展。

3. 请允许最多 12 小时让 Azure 本地资源提供程序更新扩展。

此过程允许重新安装扩展,确保它显示正确的名称 AzureEdgeRemoteSupport,并解决群集视图中观察到的任何故障。

(可选)可以使用 cmdlet sync-azurestackhci 在任何群集节点上强制同步。
更新 在此版本中,由于运行状况检查问题,导致运行 Azure Local 的单个服务器无法通过 Azure 门户进行更新。 使用 PowerShell 执行更新。 有关详细信息,请参阅通过 PowerShell 更新 Azure Local
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 解决方法是再次运行脚本,并确保在通过 Azure 门户 部署之前安装所有必需的扩展。
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。

版本 2311.3 的问题

此软件版本对应于软件版本号 10.2311.3.12。 此版本仅支持 2311 版本中的更新。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 解决方法
更新 尝试使用命令更改 AzureStackLCMUserPassword 时,可能会遇到此错误: Set-AzureStackLCMUserPassword

Can't find an object with identity: 'object id'*.
如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
Azure 本地 VM 管理 在此版本中,当使用 Azure CLI 更新附加了数据磁盘的 VM 时,操作会失败并显示以下错误消息:
找不到具有此名称的虚拟硬盘
此问题现已修复。

此版本中的已知问题

此版本中没有已知问题。 后续版本中已修复任何以前已知的问题。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误: Validator failed. Can't retrieve the dynamic parameters for the cmdlet. PowerShell Gallery is currently unavailable. Please try again later. 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 AzureEdgeRemoteSupport 扩展在群集视图中显示为“失败”,而在节点视图中显示为“成功”。 此外,节点视图还显示不正确的扩展名称“AzureEdgeRemoteSupport”。 此问题是外观上的,不会影响扩展功能。 可能需要按照以下步骤手动缓解此问题:

1. 在 Azure 门户中,导航到节点的资源组。

2.转到每个 Arc 节点并卸载远程支持扩展。

3. 请允许最多 12 小时让 Azure 本地资源提供程序更新扩展。

此过程允许重新安装扩展,确保它显示正确的名称 AzureEdgeRemoteSupport,并解决群集视图中观察到的任何故障。

(可选)可以使用 cmdlet sync-azurestackhci 在任何群集节点上强制同步。
更新 在此版本中,由于运行状况检查问题,导致运行 Azure Local 的单个服务器无法通过 Azure 门户进行更新。 使用 PowerShell 执行更新。 有关详细信息,请参阅通过 PowerShell 更新 Azure Local
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 解决方法是再次运行脚本,并确保在通过 Azure 门户 部署之前安装所有必需的扩展。
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。
Azure 本地 VM 管理 如果用于部署 Azure 本地 VM 的资源组的名称中具有下划线,则来宾代理安装将失败。 因此,您将无法启用访客管理。 请确保用于部署 Azure 本地虚拟机 的资源组中没有下划线。

版本 2311.2 的问题

此软件发布对应软件版本号 10.2311.2.7。 此版本仅支持 2311 版本中的更新。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题 变通方法/注释
添加服务器和修复服务器 在此版本中,添加服务器与修复服务器场景可能会失败并出现以下错误:

CloudEngine.Actions.InterfaceInvocationFailedException:角色“BareMetal”的类型“AddNewNodeConfiguration”引发异常:“Trace-Execution”一词无法识别为 cmdlet、函数、脚本文件或可操作程序的名称
请按照以下步骤解决此错误:

1。 在新节点上创建所需 PowerShell 模块的副本。

2. 连接到 Azure Local 系统上的节点。

3. 运行以下 PowerShell cmdlet:

Copy-Item "C:\Program Files\WindowsPowerShell\Modules\CloudCommon" "\newserver\c$\Program Files\WindowsPowerShell\Modules\CloudCommon" -recursive

有关详细信息,请参阅添加与修复服务器场景的先决条件
部署 将 2310 更新到 2311 软件时,服务主体不会迁移。 如果软件出现问题,请使用 PowerShell 迁移服务主体。
部署 如果选择“ 查看 + 创建 ”,并且尚未填写所有选项卡,则部署将开始,最终会失败。 此版本中没有已知的解决方法。
部署 如果在注册期间使用了不正确的订阅或资源组,则会看到此问题。 第二次使用 Arc 注册服务器时,Azure Edge 生命周期管理器扩展在注册过程中会失败,但扩展状态报告为“就绪”。 在您第二次进行注册之前:

请确保从服务器中删除以下文件夹: C:\ecestoreC:\CloudDeploymentC:\nugetstore
使用 PowerShell cmdlet 来删除注册表项:
Remove-Item HKLM:\Software\Microsoft\LCMAzureStackStampInformation
部署 为每个部署运行创建一个新的存储帐户。 此版本不支持现有存储帐户。
部署 为每个部署运行创建一个新的密钥保管库。 此版本不支持现有密钥保管库。
部署 在服务器硬件上,将创建 USB 网络适配器来访问基板管理控制器(BMC)。 此适配器可能会导致群集验证在部署期间失败。 在开始云部署之前,请确保禁用 BMC 网络适配器。
部署 在此版本中,对模板定义的网络直接意向替代不起作用。 使用 Azure 资源管理器模板替代此参数并为意向禁用 RDMA。
Azure 本地 VM 管理 在此操作期间自动生成的临时 SPN 密钥以连字符开头时,Azure Arc 资源网桥的部署或更新可能会失败。 此问题现已修复。
Azure 本地 VM 管理 将新服务器添加到 Azure 本地实例时,不会为新创建的卷自动创建存储路径。 此问题现已修复。
更新 在极少数情况下,更新 Azure 本地实例时可能会遇到此错误:Type 'UpdateArbAndExtensions' of Role 'MocArb' raised an exception: Exception Upgrading ARB and Extension in step [UpgradeArbAndExtensions :Get-ArcHciConfig] UpgradeArb: Invalid applianceyaml = [C:\AksHci\hci-appliance.yaml] 如果遇到此问题,请联系 Microsoft 支持部门以帮助你执行后续步骤。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
更新 在此版本中,如果在实际应用 2311.2 更新之前运行 Test-CauRun cmdlet,则会看到一条错误消息,说明缺少防火墙规则以远程关闭 Azure 本地系统。 在应用 2311.2 更新时,缺失的规则会自动创建,因此您无需执行任何操作。

应用将来的更新时,请确保运行 Get-SolutionUpdateEnvironment cmdlet 而不是 Test-CauRun
Azure 本地 VM 管理 如果用于部署 Azure 本地 VM 的资源组的名称中具有下划线,则来宾代理安装将失败。 因此,您将无法启用访客管理。 请确保用于部署 Azure 本地虚拟机 的资源组中没有下划线。

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误:验证程序失败。 无法检索 cmdlet 的动态参数。 PowerShell 库当前不可用。 请稍后重试。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 AzureEdgeRemoteSupport 扩展在群集视图中显示为“失败”,而在节点视图中显示为“成功”。 此外,节点视图还显示不正确的扩展名称“AzureEdgeRemoteSupport”。 此问题是外观上的,不会影响扩展功能。 可能需要按照以下步骤手动缓解此问题:

1. 在 Azure 门户中,导航到节点的资源组。

2.转到每个 Arc 节点并卸载远程支持扩展。

3. 请允许最多 12 小时让 Azure 本地资源提供程序更新扩展。

此过程允许重新安装扩展,确保它显示正确的名称 AzureEdgeRemoteSupport,并解决群集视图中观察到的任何故障。

(可选)可以使用 cmdlet sync-azurestackhci 在任何群集节点上强制同步。
更新 尝试使用命令Set-AzureStackLCMUserPassword更改 AzureStackLCMUserPassword 时,可能会遇到此错误:

找不到标识为“object id
”的对象。
如果出现问题,请联系 Microsoft 支持部门以执行后续步骤。
更新 在此版本中,由于运行状况检查问题,导致运行 Azure Local 的单个服务器无法通过 Azure 门户进行更新。 使用 PowerShell 执行更新。 有关详细信息,请参阅通过 PowerShell 更新 Azure Local
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 再次运行脚本,并确保在通过Azure 门户部署之前安装所有必需的扩展。
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。

版本 2311 的问题

此软件版本对应于软件版本号 10.2311.0.26。 此版本支持 2310 中的新部署和更新。

此版本的发行说明包括此版本中修复的问题、此版本中的已知问题以及从以前版本延续下来的发行说明问题。

修复的问题

下面是此版本中已修复的问题:

功能 / 特点 问题
网络 此版本不支持使用代理。
安全性 Get-AzsSyslogForwarder cmdlet 与 -PerNode 参数一起使用时,将引发异常。 无法检索多个节点的 SyslogForwarder 配置信息。
部署 在部署期间,Microsoft Open Cloud (MOC) Arc 资源网桥安装失败,并出现此错误:找不到满足要求大小 [0] 位置 [MocLocation].: OutOfCapacity“\n”的资源。
部署 在验证期间输入不正确的 DNS 会更新主机中的 DNS 配置,主机可能会丢失 Internet 连接。
部署 部署用户(在 Active Directory 预备期间称为 AzureStackLCMUserCredential)和本地管理员的密码不能包含 :(冒号)。
Azure 本地 VM 管理 通过 Azure CLI 分离磁盘会导致此版本出错。
Azure 本地 VM 管理 具有多个群集的资源组仅显示一个群集的存储路径。
Azure 本地 VM 管理 在 Azure 本地上创建 Azure 市场映像时,有时下载预配状态与 Azure 本地实例上的下载百分比不匹配。 当下载百分比报告为小于 100 时,预配状态将返回为成功。
Azure 本地 VM 管理 在此版本中,根据环境,Azure 本地系统上的 VM 部署可能需要 30 到 45 分钟。
Azure 本地 VM 管理 在 Azure Local 上通过 Azure CLI 创建 Azure Local VM 时,如果提供了市场映像的友好名称,则会生成不正确的 Azure 资源管理器 ID,并出现 VM 创建错误。

此版本中的已知问题

下面是此版本中的已知问题:

功能 / 特点 问题 变通方法/注释
部署 在将 2310 更新到 2311 软件之前,请确保在某个 Azure 本地节点上运行以下 cmdlet:
Import-module C:\CloudDeployment\CloudDeployment.psd1
Import-module C:\CloudDeployment\ECEngine\EnterpriseCloudEngine.psd1

$Parameters = Get-EceInterfaceParameters -RolePath 'MocArb' -InterfaceName 'DeployPreRequisites'

$cloudRole = $Parameters.Roles["Cloud"].PublicConfiguration

$domainRole = $Parameters.Roles["Domain"].PublicConfiguration

$securityInfo = $cloudRole.PublicInfo.SecurityInfo

$cloudSpUser = $securityInfo.AADUsers.User | Where-Object Role -EQ "DefaultARBApplication"

$cloudSpCred = $Parameters.GetCredential($cloudSpUser.Credential)

Set-ECEServiceSecret -ContainerName "DefaultARBApplication" -Credential $cloudSpCred
此脚本可帮助迁移服务主体。
部署 此版本中存在偶尔出现的检测信号可靠性问题,导致注册遇到错误:HCI 注册失败。 错误:Arc 集成失败。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 此版本中存在间歇性问题,其中 Arc 集成验证失败,并出现此错误:验证程序失败。 无法检索 cmdlet 的动态参数。 PowerShell 库当前不可用。 请稍后重试。 此问题是间歇性的。 尝试重新运行部署。 有关详细信息,请参阅 重新运行部署
部署 AzureEdgeRemoteSupport 扩展在群集视图中显示为“失败”,而在节点视图中显示为“成功”。 此外,节点视图还显示不正确的扩展名称“AzureEdgeRemoteSupport”。 此问题是外观上的,不会影响扩展功能。 可能需要按照以下步骤手动缓解此问题:

1. 在 Azure 门户中,导航到节点的资源组。

2.转到每个 Arc 节点并卸载远程支持扩展。

3. 请允许最多 12 小时让 Azure 本地资源提供程序更新扩展。

此过程允许重新安装扩展,确保它显示正确的名称 AzureEdgeRemoteSupport,并解决群集视图中观察到的任何故障。

(可选)可以使用 cmdlet sync-azurestackhci 在任何群集节点上强制同步。
更新 尝试使用命令Set-AzureStackLCMUserPassword更改 AzureStackLCMUserPassword 时,可能会遇到此错误:

找不到标识为“object id
”的对象。
此版本中没有已知的解决方法。
更新 在此版本中,由于运行状况检查问题,导致运行 Azure Local 的单个服务器无法通过 Azure 门户进行更新。 使用 PowerShell 执行更新。 有关详细信息,请参阅通过 PowerShell 更新 Azure Local
更新 从 2311 内部版本更新到 Azure Local 时,更新运行状况检查会在更新到达“安装”步骤后停止在 Azure 门户中进行报告。 Microsoft正在积极解决此问题,并且您无需执行任何动作。 尽管健康检查在门户中不可见,但它们仍然按预期运行和完成。
添加服务器和修复服务器 在此版本中,添加服务器与修复服务器场景可能会失败并出现以下错误:

CloudEngine.Actions.InterfaceInvocationFailedException:角色“BareMetal”的类型“AddNewNodeConfiguration”引发异常:“Trace-Execution”一词无法识别为 cmdlet、函数、脚本文件或可操作程序的名称
请按照以下步骤解决此错误:

1。 在新节点上创建所需 PowerShell 模块的副本。

2. 连接到 Azure Local 系统上的节点。

3. 运行以下 PowerShell cmdlet:

Copy-Item "C:\Program Files\WindowsPowerShell\Modules\CloudCommon" "\newserver\c$\Program Files\WindowsPowerShell\Modules\CloudCommon" -recursive

有关详细信息,请参阅添加与修复服务器场景的先决条件

以前版本中的已知问题

下面是以前版本中的已知问题:

功能 / 特点 问题 解决方法
Azure 门户 在某些情况下,Azure 门户可能需要一段时间才能更新,并且视图可能不是最新视图。 你可能需要等待 30 分钟或更长时间才能查看更新后的视图。
Azure 本地 VM 管理 在极少数情况下,从 Azure 门户删除 Azure 本地 VM 上的网络接口在此版本中不起作用。 使用 Azure CLI 先移除网络接口,然后将其删除。 有关详细信息,请参阅移除网络接口,并参阅删除网络接口
Azure 本地 VM 管理 在此版本中,当您创建磁盘或网络接口且名称包含下划线时,操作将会失败。 请确保不要在磁盘或网络接口的名称中使用下划线。
部署 在服务器硬件上,将创建 USB 网络适配器来访问基板管理控制器(BMC)。 此适配器可能会导致群集验证在部署期间失败。 在开始云部署之前,请确保禁用 BMC 网络适配器。
部署 为每个部署运行创建一个新的存储帐户。 此版本不支持现有存储帐户。
部署 为每个部署运行创建一个新的密钥保管库。 此版本不支持现有密钥保管库。
部署 在某些情况下,运行 Arc 注册脚本 不会安装必需的扩展、Azure Edge 设备管理或 Azure Edge 生命周期管理器。 解决方法是再次运行脚本,并确保在通过 Azure 门户 部署之前安装所有必需的扩展。
部署 第一个部署步骤:云部署之前,通过 Azure 门户部署时可能需要 45 分钟到一小时才能完成。
部署 在此版本中,对模板定义的网络直接意向替代不起作用。 使用 Azure 资源管理器模板替代此参数并为意向禁用 RDMA。
部署 如果选择“ 查看 + 创建 ”,并且尚未填写所有选项卡,则部署将开始,最终会失败。 此版本中没有已知的解决方法。
部署 如果在注册期间使用了不正确的订阅或资源组,则会看到此问题。 第二次使用 Arc 注册服务器时,Azure Edge 生命周期管理器扩展在注册过程中会失败,但扩展状态报告为“就绪”。 在您第二次进行注册之前:

请确保从服务器中删除以下文件夹:C:\ecestoreC:\CloudDeploymentC:\nugetstore
使用 PowerShell cmdlet 来删除注册表项:
Remove-Item HKLM:\Software\Microsoft\LCMAzureStackStampInformation

后续步骤