修復 Windows Admin Center 的問題

如果您剛建立新的 Azure 帳戶，且尚未登入閘道電腦上的帳戶，您可能會遇到向 Azure 註冊 Windows Admin Center 閘道的問題。

若要減輕此問題，請在另一個瀏覽器索引標籤或視窗中登入您的 Azure 帳戶，然後向 Azure 註冊 Windows Admin Center 閘道。

透過 Windows Admin Center 在 Azure 本機部署 Azure Kubernetes Service 時，只有設定 AKS 主機的使用者才能建立 Kubernetes 叢集。

若要解決此問題，請將 wssd 資料夾從設定 AKS 主機之使用者的設定檔複製到將要建立新 Kubernetes 叢集之使用者的設定檔。

您遇到部署問題或想要重設部署。

從 PowerShell 系統管理視窗執行 Uninstall-AksHci 之前，請先關閉連線至 Azure Local 上 Azure Kubernetes Service 的所有 Windows Admin Center 實例。

您可能會在任一精靈中收到錯誤錯誤設定的錯誤。

執行叢集清除作業。 這些作業可能牽涉到移除 C：\Program Files\AksHci\mocctl.exe 檔案。

主機叢集部署流程中顯示的網路功能變數名稱不一致，以及工作負載叢集部署流程。

N/A

如果您已停用快顯，就會收到此錯誤。 根據預設，Google Chrome 會封鎖彈出視窗，因此 Azure 登入彈出視窗會遭到封鎖，並導致服務主體錯誤。

啟用快顯。

從 DHCP 切換至靜態 IP 時，Windows Admin Center 會顯示錯誤，指出 WinRM 用戶端無法處理要求。 此錯誤也發生在 Windows Admin Center 外部。 使用靜態 IP 位址時，WinRM 會中斷，而伺服器在移至靜態 IP 位址時未註冊服務主體名稱 （SPN）。

若要解決此問題，請使用 SetSPN 命令來建立 SPN。 從 Windows Admin Center 閘道上的命令提示字元中，執行下列命令：

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

接下來，如果環境中的任一部機器傳回訊息 No Such SPN Found，請登入該計算機並執行下列命令：

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

最後，在 Windows Admin Center 閘道上執行下列命令，以確保它會從域控制器取得新的電腦資訊：

Klist purge 

如果您收到不正確的升級通知訊息「已成功安裝 AksHci PowerShell 模組版本 Null」，即使通知有誤導，升級作業仍會成功。

您可以放心地忽略此訊息。

在階段 2.1：基本步驟元件中，您可能會遇到此錯誤：「連線到遠端伺服器 ** 失敗，並出現下列錯誤訊息：拒絕存取。 如需詳細資訊，請參閱嘗試將認證用於伺服器節點時about_Remote_Troubleshooting說明主題。

請確定新增的帳戶/認證是計算機上的系統管理帳戶。 然後確認 PSRemoting 已啟用，且遠端主機受信任。 您可以使用下列 PowerShell 命令來執行此動作：

Enable-PSRemoting -Force 
winrm quickconfig 

如果您仍然遇到問題， 請參閱此疑難解答指南。

Windows Admin Center 目前沒有從 Azure Arc 卸除叢集的程式。

若要刪除已終結之叢集上的 Arc 代理程式，請流覽至 Azure 入口網站 中的叢集資源群組，然後手動刪除 Arc 內容。 若要刪除叢集上仍在執行中的 Arc 代理程式，您應該執行下列命令：

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

成功升級之後，Windows Admin Center 更新儀錶板仍會顯示舊版。

重新整理瀏覽器以修正此問題。

當您使用 Windows Admin Center 部署 AKS Arc 並長時間停止部署時，您可能會有認證安全性支援提供者 （CredSSP） 或連線問題。

請嘗試下列步驟來針對您的部署進行疑難解答：

1. 在執行 Windows Admin Center 的電腦上，在 PowerShell 視窗中執行下列命令：

      Enter-PSSession <servername>
   

2. 如果此命令成功，您可以連線到伺服器，而且沒有連線問題。

3. 如果您遇到 CredSSP 問題，請執行此命令來測試閘道電腦與目標電腦之間的信任：

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

   您也可以執行下列命令來測試存取本機閘道的信任：

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

如需其他 CredSSP 疑難解答秘訣，請參閱 針對 CredSSP 進行疑難解答。

有時候，由於網路問題，Windows Admin Center 會在 Arc 連線期間逾時。

使用 PowerShell 命令 Enable-AksHciArcConnection 將 AKS 工作負載叢集連線到 Azure Arc，同時積極努力改善用戶體驗。

在階段 2.1：系統驗證中，您可能會收到錯誤：「專案 'Install-Module' 無法辨識為 Cmdlet、函式、腳本檔案或可執行程式的名稱」。

檢查名稱的拼字。 如果包含路徑，請確定路徑正確無誤。 然後在安裝時再試一次。 完成您嘗試部署之節點上的PowerShell命令。 執行下列命令來解決此問題（請確定您的 PowerShell 版本至少為 5.1）：

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

如果您遇到來自第一個命令的任何錯誤，請執行下列命令：

Get-PSRepository
Register-PSRepository -Default

無法將 Windows Admin Center 連線到 Azure，因為您無法在閘道上自動建立和使用 Azure 應用程式識別碼。

建立 Azure 應用程式識別碼，並在入口網站上指派正確的許可權。 然後，選取 [ 在網關中使用現有的]。 如需詳細資訊，請瀏覽 將網關聯機至 Azure。

如果您已安裝 Kubernetes 1.19.9 版的工作負載叢集，然後使用 Windows Admin Center 將其更新為 Kubernetes 1.19.11 版，Kubernetes 更新頁面會繼續顯示更新仍在處理中。 不過，如果您執行 Get-AksHciCluster，輸出會顯示更新已完成，而且如果您在新的索引標籤中 開啟 Windows Admin Center，叢集就會更新為 Kubernetes 叢集中 的 1.19.11。

您可以忽略此問題，因為更新程式已完成。

當您回報 Windows Admin Center 的問題時，最好附加記錄以協助開發小組診斷您的問題。 Windows Admin Center 中的錯誤通常有兩種形式之一：

• 在執行 Windows Admin Center 之電腦上的事件查看器中顯示的事件
• 瀏覽器控制台中浮出水面的 JavaScript 問題

若要收集 Windows Admin Center 的記錄，請使用 Get-SMEUILogs.ps1 公開預覽套件中提供的腳本。

若要使用文稿，請在儲存文稿的資料夾中執行此命令：

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

此指令具有下列參數：

• -ComputerNames：您要從中收集記錄的計算機清單。
• -Destination：您要匯總記錄的計算機。
• -HoursAgo：收集記錄的開始時間，以執行腳本前幾個小時表示。
• -NoCredentialPrompt：關閉認證提示的切換，並在您目前的環境中使用預設認證。

如果您無法執行此文稿，您可以執行下列命令來檢視說明文字：

GetHelp .\Get-SMEUILogs.ps1 -Examples

在 Windows Admin Center 中執行升級時，發生下列錯誤：

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

當 Azure 本機上的 AKS 部署在已設定 Proxy 的環境中時，通常會發生此錯誤訊息。 目前，Windows Admin Center 不支援在 Proxy 環境中安裝模組。

若要解決此錯誤，請使用 Proxy PowerShell 命令在 Azure 本機上設定 AKS。

AKS 主機叢集部署在系統檢查時失敗，並出現 WinRM 服務錯誤。

請嘗試套用手動疑難解答中建議的解決方案。

如果您已安裝多個版本的 PowerShell 模組（例如 0.2.26、0.2.27 和 0.2.28），Windows Admin Center 可能無法使用最新版本（或它所需的版本）。

請確定您已安裝一個 PowerShell 模組。 您應該卸載所有未使用的PowerShell模組版本，並只安裝一個。 如需哪些 Windows Admin Center 版本與哪些 PowerShell 版本相容的詳細資訊，請參閱 Azure 本機版本資訊上的 AKS。

透過 Windows Admin Center 部署時，會出現此錯誤。 套件提供者需要 PackageManagement 和 Provider 標記。 您應該在嘗試透過 Windows Admin Center 部署時，檢查指定的套件是否有標籤錯誤。

此錯誤來自PowerShell，並指出有因特網連線問題。 PowerShell 正在嘗試安裝必要條件套件，但無法加以安裝。

檢查以確定伺服器或故障轉移叢集具有因特網連線能力，然後啟動全新安裝。

在階段 2.1：系統驗證中，當您叫用安裝時，可能會發生錯誤： No match was found for the specified search criteria for the provider 'NuGet'. The package provider requires 'PackageManagement' and 'Provider' tags. Please check if the specified package has the tags. 在嘗試部署的節點上完成 PowerShell 命令。 您必須使用下列 PowerShell 命令手動安裝 NuGet：

Install-PackageProvider -Name NuGet -Scope CurrentUser -Force

執行該命令之後，請關閉所有開啟的 PowerShell 視窗，然後在 Windows Admin Center 中再試一次。

在階段 2.1：系統驗證中，您可能會遇到此錯誤：「找不到存放庫 'PSGallery'。

當您按兩下 [安裝] 時，請使用 Get-PSRepository 來查看所有可用的存放庫。 完成您嘗試部署之節點上的PowerShell命令。 在系統管理 PowerShell 視窗中取消註冊並重新註冊 PSRepository。 之後關閉所有 PowerShell 視窗。

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

然後在系統管理 PowerShell 視窗中卸載並重新安裝 PowerShellGet。 之後關閉所有 PowerShell 視窗。

Uninstall-Module PowerShellGet
Install-Module PowerShellGet -Force

之後，請返回 Windows Admin Center，然後重試。

如果您使用一個帳戶安裝 Windows Admin Center，並嘗試將它與另一個帳戶搭配使用，您將會收到錯誤。

若要讓 CredSSP 在 [叢集建立精靈] 中順利運作，必須安裝並使用相同的帳戶來安裝及使用 Windows Admin Center。

從 PowerShell 移至 Windows Admin Center 以建立已啟用 Arc 的工作負載叢集時，會出現此錯誤。

您可以放心忽略這個錯誤。 這是驗證步驟的一部分，而且叢集已經建立。

重新啟動裝載管理叢集和工作負載叢集的 Azure 本機叢集節點，可能會導致工作負載叢集從 Windows Admin Center 儀錶板消失。

若要解決此問題，請先暫停並清空節點，再規劃重新啟動節點。 有時候，工作負載叢集可能需要較長的時間才會出現在儀錶板中。

Windows Admin Center 不會將 Azure Kubernetes Service 部署到具有個別記憶體和計算叢集的環境，因為它預期相同的叢集會提供計算和記憶體資源。 在大部分情況下，它不會發現計算叢集公開的 CSV，而且會拒絕繼續部署。

下一步

• 疑難排解概觀
• 安裝問題和錯誤
• 升級已知問題

如果您在使用 AKS Arc 時繼續遇到問題，您可以透過 GitHub 提出 Bug。