共用方式為

針對企業與教育Microsoft連線快取進行疑難解答

本文包含如何針對使用聯機快取時可能遇到的不同問題進行疑難解答的指示。 這些問題會依可能發生的問題分類。

已知問題

本節說明最新Microsoft連線快取企業版和教育版的已知問題。 如需最新版本中所包含之修正程式的詳細資訊，請參閱 版本資訊頁面 。

Azure 入口網站 使用者介面中的快取節點監視圖表會顯示不正確的資訊

文稿 provisionmcconwsl.ps1 在設定為使用日文語言的 Windows 11 主計算機上執行時失敗

在連線快取安裝腳本 (provisionmcconwsl.ps1) 中，會執行檢查處理，直到安裝工作的最後一個執行程式代碼 (最後一個結果) 值在下列處理中變成 0 為止。 不過，在日文OS中，傳回值是 Null，因為會顯示「最後一個結果」，而且會發生例外狀況。

暫時的因應措施是，將本機系統管理員用戶的語言設定從日文變更為英文，然後執行腳本，就不會發生上述錯誤。

取得 Azure 訂用帳戶標識碼的步驟

  1. 登入 Azure 入口網站。
  2. 選 取 [訂用帳戶]。 如果您沒有看到 [ 訂用帳戶]，請在搜尋列中輸入訂 用 帳戶。 當您開始輸入時，清單會根據您的輸入進行篩選。
  3. 如果您已經有 Azure 訂用帳戶，請跳至步驟 5。 如果您沒有 Azure 訂用帳戶，請選取左上方的 [ + 新增 ]。
  4. 選取 隨用隨付 訂用帳戶。 系統會要求您輸入信用卡資訊，但不會向您收取使用Microsoft連線快取服務的費用。
  5. 在 [ 訂用帳戶] 頁面上，您會找到目前訂用帳戶的相關詳細數據。 選取訂用帳戶名稱。
  6. 選取訂用帳戶名稱之後，您會在 [概觀] 索引卷標中找到訂用 帳戶 標識碼。選取訂用帳戶標識元旁邊的 [複製到剪貼簿 ] 圖示來複製值。

針對 Azure 資源建立進行疑難解答

線上快取 Azure 資源建立可以使用 Azure 入口網站 使用者介面或 Azure CLI 命令集來起始。

如果您在資源建立期間遇到錯誤，請檢查您是否具有在訂用帳戶下建立 Azure 資源的必要許可權，並且已在資源建立程式期間填寫所有必要的欄位。

針對快取節點設定進行疑難解答

您可以使用 Azure 入口網站 使用者介面或 Azure CLI 命令集來設定連線快取節點。

如果您遇到驗證錯誤，請確認您已填寫所有必要的組態字段。

如果您的設定似乎未生效，請檢查您是否已選取 Azure 入口網站 使用者介面中設定頁面頂端的 [儲存] 選項。

如果您已變更 Proxy 設定，您必須在主電腦上重新佈建連線快取軟體，Proxy 設定才會生效。

針對在早期預覽期間建立的快取節點進行疑難解答

在Microsoft企業與教育版連線快取 早期預覽 期間建立和部署的快取節點應該會繼續運作，但無法再透過連線快取 Azure 服務從遠端管理或監視。

因此，強烈建議您 在 Azure 中重新建立現有的資源 ，然後使用最新的 OS 特定安裝 程式，將連線快取軟體重新部署到主電腦 。

針對 Windows 主電腦的快取節點部署進行疑難解答

收集 Windows 裝載的安裝記錄

將連線快取節點部署至 Windows 主電腦 ，牽涉到執行一系列包含在 Windows 布建套件中的 PowerShell 腳本。 根據預設，這些腳本會嘗試將記錄檔寫入布建命令中指定的安裝目錄 (C:\mccwsl01\InstallLogs) 。

安裝記錄檔有三種類型：

  1. WSL_Mcc_Install_Transcript：此記錄檔會記錄執行安裝腳本時列印到PowerShell視窗的行
  2. WSL_Mcc_Install_FromRegisteredTask_Status：此記錄檔會記錄已註冊工作安裝期間所寫入的高階狀態
  3. WSL_Mcc_Install_FromRegisteredTask_Transcript：此記錄檔會記錄已註冊工作安裝期間所寫入的詳細狀態

「已註冊的工作文字記錄」通常最適合用來診斷安裝問題。

收集其他 Windows 裝載的記錄

在 Windows 主電腦上成功安裝快取節點之後，預設會定期將記錄檔寫入安裝目錄 (C:\mccwsl01\) 。

您可以預期會看到下列類型的記錄檔：

  1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript：此記錄檔會記錄負責確保連線快取繼續執行的「MCC_Monitor_Task」排程工作的輸出。
  2. WSL_Mcc_UserUninstall_Transcript：此記錄檔會記錄使用者可以執行以從主計算機卸載 MCC 軟體的「uninstallmcconwsl.ps1」腳本輸出。
  3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript：此記錄檔會記錄「MCC_Uninstall_Task」排程工作的輸出，該工作負責在「uninstallmcconwsl.ps1」腳本呼叫時，從主計算機卸載 MCC 軟體。

WSL2 無法安裝，並出現「指定的登入會話不存在」訊息

如果您嘗試在 Windows 主電腦上執行 PowerShell 命令 wsl.exe --install --no-distribution 時遇到此失敗訊息，請確認您已以本機系統管理員身分登入，並從提升許可權的 PowerShell 視窗執行命令。

更新 WSL2 核心

如果連線快取安裝因 WSL 相關問題而失敗，請嘗試執行 wsl.exe --update 以取得最新版的 WSL 核心。

檢查連線快取容器是否正在執行

線上快取軟體成功部署至 Windows 主電腦之後，您可以在 Windows 主電腦上執行下列動作，檢查快取節點是否正常執行：

  1. 在連線快取安裝期間啟動PowerShell程式，作為指定為運行時間帳戶的帳戶
  2. 執行 wsl -d Ubuntu-22.04-Mcc-Base 以存取裝載連線快取容器的Linux散發套件
  3. 執行 sudo iotedge list 以顯示哪些容器正在 IoT Edge 運行時間內執行

如果顯示edgeAgent和edgeHub容器，但未顯示 MCC，您可以使用 sudo iotedge system logs -- -f檢視 IoT Edge 安全性管理員的狀態。

您也可以使用 sudo systemctl restart iotedge重新啟動 IoT Edge 運行時間。

檢查連線快取排程工作

聯機快取容器執行之後，排程的工作會定期在連線快取運行時間帳戶下執行，以防止 WSL 清除連線快取容器。

您可以在主電腦上使用工作排程器來檢查此排程工作的狀態。

  1. 在主電腦上開啟工作排程器
  2. 流覽至 [使用中工作] 區段，然後按兩下 [MCC_Monitor_Task
  3. 選取排定的 工作MCC_Monitor_Task
  4. 選取 [ 觸發程式] 索引標籤 ，並確認 [狀態] 為 [ 已啟用]

注意

如果運行時間帳戶的密碼變更，您必須更新所有已連線快取排程工作中的使用者，才能讓連線快取節點繼續正常運作。

已成功部署快取節點，但未提供要求

如果您的快取節點未回應localhost外部的要求，可能是因為主電腦的埠轉送規則在連線快取安裝期間未正確設定。 由於 WSL 2 預設會使用虛擬化的乙太網路適配器，因此需要埠轉送規則，以允許流量從您的 LAN 連線到 WSL 2 實例。 如需詳細資訊，請參 閱使用 WSL 存取網路應用程式。

若要檢查主計算機的埠轉送規則，請使用下列 PowerShell 命令。

netsh interface portproxy show v4tov4

如果您沒有看到埠 80 到 0.0.0.0 的任何埠轉送規則，您可以從提升許可權的 PowerShell 實例執行下列命令，以將適當的轉送設定為 WSL。

netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL IP Address>

您可以從 wslip.txt 檔案擷取 WSL IP 位址，該檔案應存在於您在連線快取布建命令中指定的安裝目錄中，預設 (“c：\mccwsl01”) 。

針對Linux主電腦的快取節點部署進行疑難解答

將連線快取節點部署到Linux主電腦 ，牽涉到執行一系列包含在Linux布建套件中的Bash腳本。

線上快取軟體成功部署至 Linux 主電腦之後，您可以在 Linux 主電腦上執行下列動作，檢查快取節點是否正常執行：

  1. 執行 sudo iotedge list 以顯示哪些容器正在 IoT Edge 運行時間內執行

如果顯示edgeAgent和edgeHub容器，但未顯示 MCC，您可以使用 sudo iotedge system logs -- -f檢視 IoT Edge 安全性管理員的狀態。

您也可以使用 sudo systemctl restart iotedge重新啟動 IoT Edge 運行時間。

產生快取節點診斷支援配套

您可以執行安裝套件中包含的腳本， collectMccDiagnostics.sh 以產生包含詳細診斷信息的支援配套。

針對 Windows 主電腦，您必須執行下列動作：

  1. 在連線快取安裝期間啟動PowerShell程式，作為指定為運行時間帳戶的帳戶

  2. 將目錄變更為擷取的連線快取布建套件內的 「MccScripts」 目錄，並確認是否存在 collectmccdiagnostics.sh

  3. 執行 wsl bash collectmccdiagnostics.sh 以產生診斷支援配套

  4. 腳本完成後，請記下控制台輸出，描述診斷支援套件組合的位置

    例如，「已成功壓縮套件，請傳送在 /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz 建立的檔案」

  5. 執行 命令， wsl cp 將支援套件組合從Ubuntu散發套件內的位置複製到Windows主機OS

    例如 wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

針對 Linux 主電腦，您必須執行下列動作：

  1. 將目錄變更為擷取的連線快取布建套件內的 「MccScripts」 目錄，並確認是否存在 collectmccdiagnostics.sh

  2. 執行 collectmccdiagnostics.sh 以產生診斷支援配套

  3. 腳本完成後，請記下控制台輸出，描述診斷支援套件組合的位置

    例如，「已成功壓縮套件，請傳送在 /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz 建立的檔案」

針對快取節點監視進行疑難解答

您可以使用 Azure 入口網站 使用者介面來監視連線快取節點狀態和效能。

如果 [概觀] 索引標籤上 的基本監視 視覺效果顯示非預期或錯誤的值，請重新整理瀏覽器視窗。

如果問題持續發生，請檢查您是否已視需要設定時間範圍和快取節點篩選。

診斷和解決

您也可以使用 Azure 入口網站 介面所提供的診斷和解決問題功能。 Microsoft連線快取 Azure 資源內的這個索引標籤會引導您完成一些提示，以協助縮小問題的解決方案範圍。