評估 Azure 本機 23H2 版環境的部署整備程度

使用連線驗證程式來檢查系統中的所有機器是否具有因特網連線能力，並符合最低連線需求。 如需連線必要條件，請參閱 Azure 本機的防火牆需求。

您可以使用連線驗證程式來：

• 在收到實際硬體之前，請先檢查機器的連線能力。 您可以從將部署 Azure 本機系統之網路上的任何用戶端電腦執行連線驗證程式。
• 在部署系統之後，請檢查系統中所有機器的連線能力。 您可以在每部計算機上本機執行驗證程式 Cmdlet，以檢查每部計算機的連線能力。 或者，您可以從預備伺服器遠端連線，以檢查一或多部計算機的連線能力。

執行線上驗證程式

若要執行連線驗證程式，請遵循下列步驟。

1. 在工作站、預備伺服器或 Azure 本機電腦上本機開啟 PowerShell。

2. 輸入下列 Cmdlet 以執行連線驗證：

   Invoke-AzStackHciConnectivityValidation 
   

   注意

   Invoke-AzStackHciConnectivityValidation使用 Cmdlet 時，沒有任何參數會檢查從您的裝置啟用之所有服務端點的連線能力。 您也可以傳遞參數來執行特定案例的整備檢查。 請參閱下面的範例。

以下是使用參數執行連線驗證程式 Cmdlet 的一些範例。

範例 1：檢查遠端電腦的連線能力

在此範例中，您會從工作站或預備伺服器遠端連線，以檢查一或多個遠端系統的連線能力。

$session = New-PSSession -ComputerName remotesystem.contoso.com -Credential $credential
Invoke-AzStackHciConnectivityValidation -PsSession $Session

範例 2：檢查特定服務的連線能力

您可以傳遞 Service 參數來檢查特定服務端點的連線能力。 在下列範例中，驗證程式會檢查 Azure Arc 服務端點的連線能力。

Invoke-AzStackHciConnectivityValidation -Service "Arc For Servers"

範例 3：如果您使用 Proxy，請檢查連線能力

如果您使用 Proxy 伺服器，您可以指定連線驗證程式以透過指定的 Proxy 和認證，如下列範例所示：

Invoke-AzStackHciConnectivityValidation -Proxy http://proxy.contoso.com:8080 -ProxyCredential $proxyCredential 

範例 4：檢查連線能力並建立 PowerShell 輸出物件

您可以使用 參數，將連線檢查工具的輸出檢視為 物件 –PassThru ：

Invoke-AzStackHciConnectivityValidation –PassThru

以下是輸出的範例螢幕快照：

線上驗證程序屬性

您可以篩選下列任何屬性，並以您想要的格式顯示連線驗證程式結果：

線上驗證程序輸出

下列範例是連線驗證程式執行成功且失敗的輸出。

若要深入瞭解整備檢查報告中的不同區段，請參閱 瞭解整備檢查報告。

範例輸出：成功測試

下列範例輸出來自連線驗證程式的成功執行。 輸出表示與所有端點的健康狀態連線，包括已知的 Azure 服務和可檢視性服務。 在 [診斷] 下，您可以看到驗證程序檢查 DNS 伺服器是否存在且狀況良好。 它會收集用於診斷和數據收集的 WinHttp、IE Proxy 和環境變數 Proxy 設定。 它也會檢查輸出路徑中是否使用透明 Proxy 並顯示輸出。

範例輸出：測試失敗

如果測試失敗，連線驗證程式會傳回資訊以協助您解決問題，如下列範例輸出所示。 [需求補救] 區段會顯示造成失敗的問題。 [補救] 區段列出相關文章，以協助補救問題。

線上驗證程式的潛在失敗案例

線上驗證程式會先檢查 SSL 檢查，再測試任何必要端點的連線能力。 如果在 Azure 本機系統中開啟 SSL 檢查，您會收到下列錯誤：

因應措施

請與您的網路小組合作，關閉 Azure 本機系統的 SSL 檢查。 若要確認 SSL 檢查已關閉，您可以使用下列範例。 關閉 SSL 檢查之後，您可以再次執行工具，以檢查所有端點的連線。

如果您收到憑證驗證錯誤訊息，請針對每個端點個別執行下列命令，以手動檢查憑證資訊：

C:\> Import-Module AzStackHci.EnvironmentChecker 
C:\> Get-SigningRootChain -Uri <Endpoint-URI> | ft subject 

例如，如果您想要驗證兩個端點的憑證資訊，例如 https://login.microsoftonline.com 和 https://portal.azure.com，請針對每個端點個別執行下列命令：

• 針對 https://login.microsoftonline.com：

  C:\> Import-Module AzStackHci.EnvironmentChecker 
  C:\> Get-SigningRootChain -Uri https://login.microsoftonline.com | ft subject
  

  以下是範例輸出：

  Subject
  -------
  CN=portal.office.com, O=Microsoft Corporation, L=Redmond, S=WA, C=US
  CN=Microsoft Azure TLS Issuing CA 02, O=Microsoft Corporation, C=US
  CN=DigiCert Global Root G2, OU=www.digicert.com, O=DigiCert Inc, C=US
  

• 針對 https://portal.azure.com：

  C:\> Import-Module AzStackHci.EnvironmentChecker
  C:\> Get-SigningRootChain -Uri https://portal.azure.com | ft Subject 
  
  

  以下是範例輸出：

  Subject
  -------
  CN=portal.azure.com, O=Microsoft Corporation, L=Redmond, S=WA, C=US
  CN=Microsoft Azure TLS Issuing CA 01, O=Microsoft Corporation, C=US
  CN=DigiCert Global Root G2, OU=www.digicert.com, O=DigiCert Inc, C=US
  

硬體驗證程式會檢查機器和其他硬體元件 是否符合系統需求。 例如，它會檢查系統中的所有實體機器是否已統一設定，且所有硬體元件都使用相同的韌體版本，並且如預期般運作。

建議您在開始部署之前，先使用硬體驗證程式。

如需硬體驗證程式在不同硬體元件上執行之測試的描述，請參閱下表：

執行硬體驗證程式

若要執行硬體驗證程式，請遵循下列步驟。

1. 在 Azure 本機電腦上以系統管理員身分開啟 PowerShell。

2. 執行下列 Cmdlet 以叫用硬體驗證程式：

   Invoke-AzStackHciHardwareValidation 
   

以下是使用硬體驗證器的一些範例。

範例 1：檢查一或多部遠端計算機的硬體整備程度

在此範例中，您會從工作站或預備伺服器遠端連線，以檢查兩個遠端系統的硬體整備程度。

$session = New-PSSession –ComputerName remotesystem1.contoso.com,remotesystem2.contoso.com -Credential $credential  

Invoke-AzStackHciHardwareValidation -PsSession $Session 

硬體驗證程序輸出

下列範例是硬體驗證程式執行成功且失敗的輸出。

若要深入瞭解整備檢查報告中的不同區段，請參閱 瞭解整備檢查報告。

範例輸出：成功測試

下列範例是成功執行硬體驗證器的輸出：

範例輸出：測試失敗

下列範例是硬體驗證程式執行失敗的輸出：

此範例輸出指出在繼續進行部署之前，您必須修正的七個重要問題。 系統中的一部電腦與其他人沒有相同的網路適配器。 此外，該計算機中的部分網路適配器屬性不符合最低需求。

在此版本中，您必須執行 Active Directory 準備工具，以建立群組受控服務帳戶 （gMSA），並透過部署在專用組織單位 （OU） 中加以探索。

使用 Active Directory 驗證程式來：

• 驗證 Active Directory 準備工具是否已執行，且 gMSA 已設定，並在開始部署之前布建群組。
• 在部署期間評估任何 Active Directory 問題。 支援小組可以檢查驗證程式報告記錄，以評估您是否在部署之前執行 Active Directory 準備工具。

執行 Active Directory 驗證程式

若要從 Azure 本機電腦節點、工作站或預備伺服器本機執行 Active Directory 驗證程式，請遵循下列步驟。

1. 請確定下列參數在每部機器的 Active Directory 中是唯一的：

   • Azure 本機部署使用者
   • Azure 本機組織單位名稱
   • Azure 本機部署前置詞 （必須最多八個字元）
   • Azure 本機部署實例名稱
   • 實體節點物件（如果已建立）必須在巢狀計算機組織單位下提供

2. 以系統管理員身分在 PowerShell 中執行下列命令：

   $params = @{
   ADOUPath = 'OU=Hci001,DC=contoso,DC=local'
   DomainFQDN = 'contoso.local'
   NamingPrefix = "hci"
   ActiveDirectoryServer = 'contoso.local'
   ActiveDirectoryCredentials = (Get-Credential -Message 'Active Directory Credentials')
   ClusterName = 'S-Cluster'
   PhysicalMachineNames = "node01, node02, node03, node04"
   }
   Invoke-AzStackHciExternalActiveDirectoryValidation @params
   

   Cmdlet Invoke-AzStackHciExternalActiveDirectoryValidation 會檢查 Active Directory 和組策略物件 （GPO） 模組是否可用，如果不是，則會嘗試安裝它們。

Active Directory 驗證程序輸出

下列範例是 Active Directory 驗證程式執行成功且失敗的輸出。

若要深入瞭解整備檢查報告中的不同區段，請參閱 瞭解整備檢查報告。

範例輸出：成功測試

下列範例是成功執行 Active Directory 驗證器的輸出。 輸出指出指定的 OU 存在，並包含適當的子 OU。

範例輸出：測試失敗

下列範例是 Active Directory 驗證程式執行失敗的輸出。 報告指出 Active Directory 工具尚未執行，且未建立適當的組織單位（OU）。

若要補救此輸出中的封鎖問題，請開啟 Active Directory 工具並傳遞下列參數：

.\AsHciADArtifactsPreCreationTool.ps1 -AsHciDeploymentUserCredential (get-credential) -AsHciOUName "OU=Hci001,DC=contoso,DC=local,DC=stbtest,DC=microsoft,DC=com" -AsHciPhysicalNodeList @("Physical Machine1", "Physical Machine2") -DomainFQDN "'contoso.local " -AsHciClusterName "s-cluster" -AsHciDeploymentPrefix "Hci001"

配置給 Azure 本機的 IP 位址可能已經在網路上作用中。 網路驗證程式會驗證您的網路基礎結構，以取得為部署保留的有效IP範圍。 它會嘗試 Ping 並連線到 WinRM 和 SSH 埠，以確保沒有使用中主機使用保留 IP 範圍的 IP 位址。

網路驗證程式也會檢查記憶體連線、配接器驅動程式整備，以及其他主機網路設定整備程度。

您會提供回應檔案 JSON 作為網路驗證程式 Cmdlet 呼叫的輸入。 或者，您可以在執行驗證程式 Cmdlet 時手動提供個別參數。

執行網路驗證程式

若要在 Azure 本機節點上使用回應檔案本地運行網路驗證器，請使用下列命令：

$allServers = "<ARRAY OF SERVERS' IP>" # you need to use IP for the connection 
$userName = "<LOCALADMIN>" 
$secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force 
$hostCred = New-Object System.Management.Automation.PSCredential($userName, $secPassWord) 
[System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @() 
foreach ($currentServer in $allServers) { 
   $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $hostCred -ErrorAction Stop 
   $allServerSessions += $currentSession 
} 
$answerFilePath = "<ANSWERFILELOCATION>" # Like C:\MASLogs\Unattended-2024-07-18-20-44-48.json 
Invoke-AzStackHciNetworkValidation -DeployAnswerFile $answerFilePath -PSSession $allServerSessions -ProxyEnabled $false 

若要使用個別參數在 Azure 本機節點上本機執行網路驗證程式，請使用下列命令：

$answerFilePath = "<ANSWERFILELOCATION>" 
$managementSubnetCIDR = "<CIDR string for management subnet>" 
$logOutputPath = "<LOGFILELOCATION>" 
$userName = "<LOCALADMIN>" 
$secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force 
$sessionCredential = New-Object System.Management.Automation.PSCredential($userName, $secPassWord) 
$answerFileContent = Get-Content $answerFilePath -Raw | ConvertFrom-Json 
$ipPools = New-Object System.Collections.ArrayList 
[System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @() 
foreach ($ipPool in $answerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].ipPools) { 
   $currentPoolObject = [PSCustomObject] @{ 
     StartingAddress = $ipPool.StartingAddress 
     EndingAddress = $ipPool.EndingAddress 
   } 
   $ipPools.Add($currentPoolObject) 
} 
[PSObject[]] $atcHostIntentsInfo = $answerFileContent.scaleUnits[0].deploymentData.hostNetwork.intents 
[System.String[]] $allServers = $answerFileContent.scaleUnits[0].deploymentData.physicalNodes.Name 
[System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @() 
foreach ($currentServer in $allServers) { 
   $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $sessionCredential -ErrorAction Stop 
   $allServerSessions += $currentSession 
} 
Invoke-AzStackHciNetworkValidation -IpPools $ipPools -ManagementSubnetValue $managementSubnetCIDR -PSSession $allServerSessions -SessionCredential $sessionCredential -OutputPath $logOutputPath -AtcHostIntents $atcHostIntentsInfo 

網路驗證程式範例輸出

以下是網路驗證程式執行失敗的範例輸出。 因為網路適配器只有兩個IP位址，所以會發生失敗。

若要深入瞭解整備檢查報告中的不同區段，請參閱 瞭解整備檢查報告。

Arc 整合驗證程式可協助評估 Azure 本機系統是否符合成功 上線 Azure Arc 所需的所有必要條件。

您可以使用 Arc 整合驗證程式來驗證下列專案：

• Arc 資源群組尚未包含 Arc 資源，其名稱與您嘗試上線之叢集中的節點相同。
• 在不同的訂用帳戶標識碼或資源群組中，尚未啟用一或多個節點。
• 指定的 Azure 區域有效。
• 訂用帳戶中的資源群組限制未達到。
• 找不到註冊資源群組中的 Azure 本機資源計數限制。
• 未達到訂用帳戶中的角色指派計數限制。

執行 Arc 整合驗證程式

1. 在任何 Azure 本機電腦上開啟 PowerShell。

2. 執行下列命令，以使用您想要將 Azure 本機系統上線的帳戶連線至 Azure：

   Connect-AzAccount -Tenant <Your_tenant_ID> -Subscription <Your_subscription_ID> -DeviceCode
   

3. 執行下列命令，以建立包含 Azure 本機電腦名稱的數位變數：

   $nodes = [string[]]("host1"," host2"," host3"," host4")
   

4. 執行下列命令以叫用驗證程式：

   Invoke-AzStackHciArcIntegrationValidation -SubscriptionID <Your_subscription_ID> -ArcResourceGroupName <ARC_resourcegroup_name> -NodeNames $nodes
   

   其中：

   • Arc_resourcegroup_name 代表您打算用來將 Azure 本機系統上線的資源群組。

Arc 整合驗證程序輸出

下列範例是 Arc 整合驗證程式執行成功且失敗的輸出。

若要深入瞭解整備檢查報告中的不同區段，請參閱 瞭解整備檢查報告。

範例輸出：成功測試

下列範例是成功執行 Arc Integration 驗證程序的輸出。 輸出指出資源群組內沒有任何現有的 Arc 資源，其名稱與目前系統中的節點相同。

範例輸出：測試失敗

下列範例是 Arc 整合驗證程式執行失敗的輸出。 此輸出顯示資源群組中現有的 Arc 資源與目前系統中的節點共用相同名稱。 若要讓叢集上線成功，您必須選取替代資源群組來將叢集上線，或從現有的資源群組中移除衝突的 Arc 資源，以修正此衝突。