針對 Azure Arc VM 管理進行疑難解答

發行項
02/07/2024

適用於：Azure Stack HCI 版本 23H2

本文提供如何在 Azure Stack HCI 叢集中收集記錄和疑難解答 Azure Arc 虛擬機 (VM) 問題的指引。它也會列出 Azure Arc VM 管理目前存在的限制和已知問題。

收集記錄

您可以收集記錄，以識別 Azure Stack HCI 系統中 Arc VM 的問題並進行疑難解答。請先使用這些記錄來收集重要資訊，再連絡 Microsoft 支援服務以取得其他協助。

請確定您有最新的 PowerShell 模組進行記錄收集。若要更新 PowerShell 模組，請執行下列命令：

#Update the PowerShell module
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense

若要收集 Azure Stack HCI 叢集中 Arc VM 的記錄，請執行下列命令：

$csv_path="<input-from-admin>"
$VMIP_1="<input-from-admin>"
az login --use-device-code
Get-ArcHCILogs -workDirectory $csv_path\ResourceBridge -kvaTokenPath $csv_path\ResourceBridge\kvatoken.tok -ip $VMIP_1

位置:

$csv_path 是用來建立 Arc Resource Bridge 所提供的叢集共用磁片區的完整路徑。
$VMIP_1 是 Arc 資源網橋 VM 的 IP 位址。
您可以選擇性地設定 -logDir 參數，以指定儲存所產生記錄檔之目錄的路徑。如果您未指定路徑或參數，則記錄預設會儲存在目前的工作目錄中。

針對 Azure Arc VM 進行疑難解答

本節說明與 Azure Arc VM 管理及其建議解決方案相關的錯誤。

嘗試啟用來賓管理時失敗

試著執行命令以啟用來賓管理時，您會看到下列錯誤：

錯誤：Deployment failed. Correlation ID: 5d0c4921-78e0-4493-af16-dffee5cbf9d8. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

上述失敗的原因是未為此 VM 建立受控識別。需要系統指派的受控識別才能啟用客體管理。

解決方法：

請遵循下列步驟，確認未為此 VM 建立受控識別，然後啟用系統指派的受控識別。

在 Azure 入口網站中，移至 VM。流覽至 [ 概觀] 頁面。在 [ 屬性] 索引 標籤 的 [設定] 底下， [來賓管理 ] 應該會顯示為 [已停用]。從右上角選取 [JSON 檢視 ]。
在參數下 Identity ， type 應該會顯示為 None。
若要建立受控識別，請透過 RDP 連線到 Azure Stack HCI 伺服器。執行以下命令：
```
az extension add --name connectedmachine
```

確認已連線的機器 CLI 擴充功能已安裝在叢集上。以下是已成功安裝延伸模組的範例輸出。 connectedmachine表示已安裝 0.7.0 版。

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2”,
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": “0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

執行下列命令，將系統受控識別指派給 VM。

az connectedmachine update --ids "<ARM ID for the VM>" --set identity.type="SystemAssigned"

移至 Azure 入口網站並流覽至 [概觀] 頁面。 JSON 檢視應該指出系統受控識別現在已指派給 VM。

無法辨識 Azure CLI 安裝

如果您的環境在安裝后無法辨識 Azure CLI，請執行下列程式代碼區塊，將 Azure CLI 安裝路徑新增至環境路徑。

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

下一步

Azure Arc VM 管理常見問題