將更新匯入 IoT 中樞裝置更新

瞭解如何取得新的更新，並將更新匯入 IoT 中樞裝置更新。 如果您尚未這麼做，請務必檢閱重要的匯入概念，以及如何準備要匯入的更新。

必要條件

• 存取已啟用 IoT 中樞裝置更新的 IoT 中樞。

• 未啟用私人端點的 Azure 儲存體 容器。

  • 如果您不確定是否已啟用私人端點，請移至 [私人連結中心]，選取左側的 [私人端點]，然後在 [資源] 資料行中尋找您的 Azure 儲存體 帳戶名稱。

• IoT 中樞內針對裝置更新佈建的 IoT 裝置 (或模擬器)。

• 請依照準備更新以匯入 IoT 中樞裝置更新一文中的步驟，建立更新檔案的匯入資訊清單。

Azure 入口網站

支援的瀏覽器：

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI 環境：

• 在 Azure Cloud Shell 中使用 Bash 環境。

  

• 或是，若要在本地執行 CLI 參考命令，請安裝 Azure CLI

  1. 使用 az login 命令來登入 Azure CLI。
  2. 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。
  3. 出現提示時，請在第一次使用時安裝 Azure CLI 擴充功能。 本文中的命令會使用 azure-iot 延伸模組。 執行 az extension update --name azure-iot 以確定您使用的是最新版本的延伸模組。

提示

本文中的 Azure CLI 命令使用反斜線 \ 字元達到行和行之間的接續，讓命令引數更易於閱讀。 此語法適用於 Bash 環境。 如果您要在 PowerShell 中執行這些命令，請將每個反斜線取代為倒引號 '''，或將其完全移除。

匯入更新

本節說明如何使用 Azure 入口網站或 Azure CLI 匯入更新。 您也可以改用 IoT 中樞 API 的裝置更新來匯入更新。

若要匯入更新，您必須先將更新檔案和匯入資訊清單上傳至 Azure 儲存體容器。 然後，您會將更新從 Azure 儲存體匯入 IoT 中樞的裝置更新，以便您將更新儲存至裝置。

Azure 入口網站

1. 登入 Azure 入口網站，瀏覽至具有裝置更新的 IoT 中樞。

2. 在頁面左側，選取 [裝置管理] 底下的 [更新]。

   

3. 從畫面頂端的索引標籤清單中選取 [更新] 索引標籤。

   

4. 選取 [可用更新] 標題下方的 [+ 匯入新更新]。

   

5. 選取 [+ 從儲存體容器選取]。 會顯示儲存體帳戶 UI。 選取現有帳戶，或使用 [+ 儲存體帳戶] 建立新帳戶。 此帳戶用於容器，以將更新分段匯入。 帳戶不應該同時啟用公用和私人端點。

   

6. 選取儲存體帳戶之後，就會顯示容器 UI。 選取現有的容器，或使用 [+ 容器] 建立容器。 此容器會用來暫存要匯入的更新檔案

   建議您每次匯入更新都使用新的容器。 一律使用新的容器可以協助您避免不小心匯入先前更新的檔案。 如果您沒有使用新的容器，請務必先刪除現有容器中的任何檔案，再完成此步驟。

   

7. 在容器中，選取 [上傳]。 會顯示上傳 UI。

   

8. 選取 [上傳 Blob] 標題底下，選取 [檔案] 區段右側的資料夾圖示。 使用檔案選擇器瀏覽至更新檔案的位置並匯入資訊清單，選取所有檔案，然後選取 [開啟]。 您可以按住 Shift 鍵，然後按一下以多重選取檔案。

   

9. 選取所有更新檔案後，請選取 [上傳]。

   

10. 選取已上傳的檔案，以指定為要匯入的檔案。 然後選取 [選取] 按鈕，以返回 [匯入更新] 頁面。

    

11. 在 [匯入更新] 頁面上，檢閱要匯入的檔案。 然後選取 [匯入更新] 以啟動匯入程序。 若要解決任何錯誤，請參閱 Proxy 更新疑難排解。

    

12. 匯入程序隨即開始，畫面會切換至 [匯入歷程記錄] 區段。 選取 [重新整理] 可檢視進度，直到匯入程序完成 (視更新大小而定，程序可能會在幾分鐘內完成，但也可能需要較長的時間)。

    

13. 當 [狀態] 資料行指出匯入成功時，請選取 [可用更新] 標題。 您現在應該會在清單中看到您匯入的更新。

    

Azure CLI

az iot du update stage 命令處理匯入更新的必要步驟，包括將更新檔案上傳至目標儲存體容器。 選擇性旗標也可以讓此命令在檔案準備好之後自動匯入檔案。 否則，az iot du update import 命令會完成該程序。

stage 命令採用下列引數：

• --account：裝置更新帳戶名稱。
• --instance：裝置更新執行個體名稱。
• --manifest-path：應暫存的匯入資訊清單檔案路徑。
• --storage-account：要暫存更新的儲存體帳戶名稱。
• --storage-container：在所選儲存體帳戶內，要暫存更新的容器名稱。
• --overwrite：選擇性旗標，指出如果發生衝突，是否要覆寫儲存體容器中的現有 Blob。
• --then-import：選擇性旗標，指出更新在暫存後是否應該匯入裝置更新。

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

例如：

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

如果您有多個匯入資訊清單，您可以將其全部包含在單一命令中。 例如：

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

如果您不使用 --then-import 旗標，命令的 stage 輸出會包含執行 az iot du update import 的提示，包括預先填入的引數。

使用 az iot du update list 確認已成功匯入您的更新或更新。

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

如果您改為使用 API 匯入

您也可以程式設計的方式匯入更新：

• 針對 .NET、Java、JavaScript 或 Python 使用 Azure SDK
• 使用匯入更新 REST API
• 使用樣本 PowerShell 模組
  • 需要 PowerShell 5 或更新版本 (包括 Linux、macOS 和 Windows 安裝)

注意

如需必要的 API 權限，請參閱裝置更新使用者角色和存取。

更新檔案和匯入資訊清單必須上傳至 Azure 儲存體 Blob 容器以進行分段。 若要匯入分段的檔案，請將 Blob URL 或私人 Blob 的共用存取簽章 (SAS) 提供給裝置更新 API。 如果使用 SAS，請務必提供三個小時以上的到期時間範圍

提示

若要將大型更新檔案上傳至 Azure 儲存體 Blob 容器，您可以使用下列其中一項來提升效能：

• AzCopy
• Azure 儲存體總管

後續步驟

• 建立群組
• 了解匯入概念