共用方式為

針對雲端和部署問題進行疑難解答

  • 發行項

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

雲端和部署有兩個主要類型的潛在問題：與雲端相依 azsphere 命令互動的問題，以及裝置未更新的問題。

針對雲端 CLI 命令進行疑難解答

當您使用 雲端相依 azsphere 命令時，Azure Sphere 安全性服務會代表命令行介面 （CLI） 執行作業。 為了避免公開個別租使用者、使用者或裝置的相關信息，因而有資訊外泄的風險，安全性服務在某些情況下會傳回一般錯誤訊息，azsphere 命令會傳遞給您。

以下是診斷和解決這類錯誤的一般疑難解答秘訣。

如果您在 Windows 上遇到間歇性登入錯誤，特別是使用個人Microsoft帳戶，請嘗試在登入時使用 --use-device-code 選項，並遵循提示中的指示：

azsphere login --use-device-code

Windows SDK 20.04 版 Update 2 和更新版本支援此選項。

如果雲端相依命令失敗，請先檢查命令本身：

  • 您是否指定了正確的參數？
  • 如果命令包含裝置、裝置群組或其他專案的標識碼，您確定它是正確的標識碼嗎？
  • 您是否嘗試建立已經存在的裝置群組、產品或其他專案？ 產品名稱在租用戶內必須是唯一的。 裝置組名在產品內必須是唯一的，且不區分大小寫。

接下來，檢查您的登入身分識別和租使用者：

  • 您是否使用有效的登入身分識別登入 Azure Sphere？
  • 您是否存取正確的租使用者？
  • 您是否已變更登入身分識別？ 每個身分識別都必須向 Azure Sphere 註冊，而且必須在租使用者中具有指派的角色。 例如，如果您變更登入，藉由變更電子郵件位址，您不僅 必須註冊新的身分識別，還必須確定新身分識別已獲指派角色。

檢查您的裝置：

  • 某些命令需要裝置連線到您的電腦。

最後，請確定租使用者中的使用者角色會授與您執行作業的許可權：

  • 如果命令寫入任何數據，您必須是參與者或系統管理員。 讀取器無法寫入數據，因此無法建立租使用者、裝置群組或產品、新增或刪除裝置功能、上傳映射套件，或執行任何其他動作來變更儲存在租使用者或裝置上的資訊。

Register-user 錯誤

如果您嘗試使用 azsphere register-user 命令，您會看到錯誤訊息，因為此命令已被取代。 您應該使用 替代機制來註冊使用者。

針對裝置更新進行疑難排解

無線更新 是 Azure Sphere 安全性模型的重要部分。 OS 更新和部署更新都可能發生問題。

針對操作系統更新進行疑難解答

若要讓裝置接收 OS 更新，裝置必須連線到因特網。 如果您的裝置似乎正在執行過時的 Azure Sphere OS 版本，請確認您的因特網連線，如針對網路問題進行疑難解答中所述。

如果裝置執行 21.04 之前的 OS，則載入裝置的任何 面板組態映像 也必須載入裝置所宣告租使用者的雲端帳戶。

將面板設定側載至裝置可允許初始乙太網路設定。 不過，對於執行 21.01 OS 前作業系統的裝置，如果該面板組態映像未包含在部署中，裝置將無法執行任何更新。 這是因為此設定會導致從裝置移除面板組態，並可能失去因特網連線能力。 如果您的其中一部裝置發生此問題，您必須將原始面板組態映射上傳至裝置所宣告租使用者的雲端帳戶。

針對部署更新進行疑難解答

若要讓裝置取得 部署 更新，下列所有專案都必須成立：

  • 必須連線至網際網路。 如果您懷疑您的裝置未連線到因特網，請參閱 針對網路問題進行疑難解答。
  • 它不得具有應用程式開發功能。
  • 它必須 宣告至租使用者。
  • 它必須屬於 裝置群組。
  • 其所屬的裝置群組必須以部署為目標。
  • 部署必須包含由或代表貴組織建立的應用程式映像（以及選擇性的面板組態映射）。
  • 裝置群組必須有 UpdateAll 更新原則。

Azure Sphere 支援每個裝置的單一租使用者。 這表示您的組織會控制部署至裝置的所有客戶映像。

拿掉應用程式開發功能會移除未簽署生產環境的所有側載映像。

宣告裝置的問題

裝置只能宣告一次。 一旦宣告，裝置就會永久與 Azure Sphere 租使用者相關聯。 如果在向租使用者宣告裝置時回報錯誤，下列其中一個可能是原因：

  • 確認您使用的是先前尚未用來 建立租使用者的未認領裝置。
  • 確認您具有在所選 Azure Sphere 租用戶中執行 azsphere device claim 命令的正確許可權。
  • 在製造期間未註冊 Azure Sphere 裝置的罕見事件中，請連絡您的Microsoft代表，使其正確註冊。 如需詳細資訊，請參閱 宣告晶元。