验证 Azure Stack Hub 的数据中心网络集成

使用 Azure Stack Hub 就绪性检查器工具（AzsReadinessChecker）验证数据中心网络是否已准备好部署 Azure Stack Hub。在 Azure Stack Hub 部署之前验证数据中心网络集成。

就绪情况检查器工具中的网络验证可以在两种不同的模式下运行。在接收 Azure Stack Hub 硬件之前，请使用设备模式来验证数据中心网络就绪情况。设备模式需要使用物理服务器以及本文后面列出的硬件规范。在 Azure Stack Hub 硬件到达并连接到数据中心网络后，通过在 Azure Stack Hub 的硬件生命周期主机上运行就绪情况检查器工具，使用 HLH 模式。 HLH 模式不需要其他硬件。

就绪情况检查器将验证：

边界连接
交换机配置
DNS 集成
DNS 转发器
时间服务器
Microsoft Entra 网络连接
AD FS 和 Graph 连接
重复的 IP 地址分配

有关 Azure Stack Hub 数据中心集成的详细信息，请参阅 Azure Stack 的网络集成规划。

获取就绪情况检查器工具

从 PowerShell 库下载最新版本的 Azure Stack Hub 就绪性检查器工具（AzsReadinessChecker）。

从 PowerShell 库下载最新版本的 Posh-SSH 模块。

获取虚拟路由器映像

Azure Stack Hub 就绪情况检查器工具使用基于 SONiC 交换机作系统的虚拟路由器映像。下载 Hyper-V 的 SONiC 虚拟交换机映像的最新版本。

硬件先决条件

硬件要求仅适用于在设备模式下运行就绪情况检查器。

就绪情况检查器工具可以在满足以下最低要求的硬件设备上运行：

具有硬件虚拟化功能的单个 x64 CPU
8 GB RAM
64 GB 的本地存储
网络接口的数量和类型等于边界交换机连接的数量和类型，例如 4 x SFP28 网络端口
标准 KVM 输入/输出

请注意，就绪情况检查器设备中的网络接口数可能小于使用 BGP 路由时的边界连接数。逐个验证边界连接。拥有四个单独的网络接口可提供最佳体验。有关路由注意事项，请参阅边界连接。

软件必备项

软件先决条件适用于在设备和 HLH 模式下运行就绪情况检查器。

运行该工具的计算机必须具备以下软件：

Windows Server 2019 或 Windows Server 2016
已安装 Hyper-V 和 Hyper-V 管理工具功能
Microsoft Azure Stack Hub 就绪性检查器工具的最新版本。
SONiC 虚拟交换机映像的最新版本。
Posh-SSH PowerShell 模块的最新版本。
部署工作表已填写完毕并导出到 DeploymentData.json 文件。

在设备模式下验证数据中心网络集成

将满足先决条件的物理设备直接连接到为 Azure Stack Hub 指定的边界交换机端口，该端口具有适当的网络电缆和收发器类型。
打开管理 PowerShell 提示符，然后运行以下命令以初始化 AzsReadinessChecker：
```
Import-Module Microsoft.AzureStack.ReadinessChecker
```
在 PowerShell 提示符下运行以下命令以开始验证。为 -DeploymentDataPath 和 -VirtualRouterImagePath 参数指定正确的值。
```
Invoke-AzsNetworkValidation -DeploymentDataPath C:\DeploymentData.json -VirtualRouterImagePath C:\sonic-vs.vhdx
```
工具运行后，查看输出。确认所有测试的状态是否正常。如果状态不正常，请查看详细信息和日志文件以了解其他信息。

在 HLH 模式下验证数据中心网络集成

使用 HLHAdmin 帐户登录到 HLH。
打开管理 PowerShell 提示符，然后运行以下命令以初始化 AzsReadinessChecker：
```
Import-Module Microsoft.AzureStack.ReadinessChecker
```
在 PowerShell 提示符下运行以下命令以开始验证。为 -DeploymentDataPath 和 -VirtualRouterImagePath 参数指定正确的值。
```
Invoke-AzsNetworkValidation -DeploymentDataPath C:\DeploymentData.json -VirtualRouterImagePath C:\sonic-vs.vhdx -HLH
```
工具运行后，查看输出。确认所有测试的状态是否正常。如果状态不正常，请查看详细信息和日志文件以了解其他信息。

Syntax

Invoke-AzsNetworkValidation
    -DeploymentDataPath <String>
    [-RunTests <String[]>]
    [-SkipTests <String[]>]
    [-VirtualRouterImagePath <String>]
    [-DnsName <String>]
    [-MtuTestDestination <String>]
    [-CustomCloudArmEndpoint <Uri>]
    [-CustomUrl <Uri[]>]
    [-OutputPath <String>]
    [-CleanReport]
    [<CommonParameters>]

Invoke-AzsNetworkValidation
    -DeploymentDataPath <String>
    [-VirtualRouterImagePath <String>]
    [-CustomCloudArmEndpoint <Uri>]
    [-VirtualSwitchName <String>]
    [-NoUplinksRequired]
    [-NetworkToTest <String>]
    [-HLH]
    [-OutputPath <String>]
    [-CleanReport]
    [<CommonParameters>]

参数

-CleanReport

删除所有以前的进度并创建一个干净的报表。

Type: SwitchParameter
Parameter Sets: (All)
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CustomCloudArmEndpoint

自定义云的 Azure 资源管理器终结点 URI。

Type: String
Parameter Sets: (All)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CustomUrl

要测试的其他 URL 列表。

Type: String[]
Parameter Sets: Hub
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentDataPath

部署工作表创建的 Azure Stack Hub 部署配置文件的路径。

Type: String
Parameter Sets: (All)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DnsName

要解析 DNS 测试的 DNS 名称。

Type: String
Parameter Sets: (All)
Position: Named
Default value: management.azure.com
Accept pipeline input: False
Accept wildcard characters: False

-HLH

指示就绪情况检查器的 HLH 模式。

Type: SwitchParameter
Parameter Sets: HLH
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-MtuTestDestination

网络路径 MTU 测试的 DNS 名称或 IP 地址。

Type: String
Parameter Sets: Hub
Position: Named
Default value: go.microsoft.com
Accept pipeline input: False
Accept wildcard characters: False

-NetworkToTest

只允许对其中一个网络执行测试。默认设置是为 BMC 和外部网络执行的测试。

Type: String
Parameter Sets: HLH
Accepted values: BmcNetworkOnly, ExternalNetworkOnly
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-无需上行链路

指示应跳过 P2P 接口上的 ping 测试。

Type: SwitchParameter
Parameter Sets: HLH
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-OutputPath

日志和报告输出的目录路径。

Type: String
Parameter Sets: (All)
Position: Named
Default value: $env:TEMP\AzsReadinessChecker
Accept pipeline input: False
Accept wildcard characters: False

-RunTests

要运行的测试列表。默认值为运行所有测试。

Type: String[]
Parameter Sets: Hub
Accepted values: LinkLayer, PortChannel, BorderUplink, IPConfig, BgpPeering, BgpDefaultRoute, DnsServer, PathMtu, TimeServer, SyslogServer, AzureEndpoint, AdfsEndpoint, Graph, DuplicateIP, DnsDelegation
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SkipTests

要跳过的测试列表。默认值为不跳过任何测试。

Type: String[]
Parameter Sets: Hub
Accepted values: PortChannel, BorderUplink, IPConfig, BgpPeering, BgpDefaultRoute, DnsServer, PathMtu, TimeServer, SyslogServer, AzureEndpoint, AdfsEndpoint, Graph, DuplicateIP, DnsDelegation
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-VirtualRouterImagePath

sonic-vs.vhdx 映像的完整路径。

Type: String
Parameter Sets: (All)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-虚拟交换机名称

HLH 上的外部 Hyper-V 交换机名称。

Type: String
Parameter Sets: HLH
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

报告和日志文件

每次运行验证时，都会将结果记录到 AzsReadinessChecker.log 和 AzsReadinessCheckerReport.json。这些文件的位置与 PowerShell 中的验证结果一起显示。

在部署 Azure Stack Hub 或调查验证问题之前，验证文件可帮助你共享状态。这两个文件都保留每个后续验证检查的结果。该报告让您的部署团队确认身份配置。日志文件可帮助部署或支持团队调查验证问题。

默认情况下，这两个文件都写入到 C:\Users\<username>\AppData\Local\Temp\AzsReadinessChecker\。

用：

-OutputPath：运行命令末尾 的路径 参数，用于指定不同的报表位置。
-CleanReport：在 run 命令尾部的参数，用于清除 AzsReadinessCheckerReport.json 中的先前报表信息。有关详细信息，请参阅 Azure Stack Hub 验证报告。

验证失败

如果验证检查失败，则有关失败的详细信息会显示在 PowerShell 窗口中。该工具还会将信息记录到 AzsReadinessChecker.log。

后续步骤

查看就绪情况报告
 常规 Azure Stack Hub 集成注意事项

Last updated on 2025-11-20

通过