將更新匯入至裝置更新以進行 IoT 中樞

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

必要條件

• 存取已啟用 IoT 中樞裝置更新的 IoT 中樞。
• 在 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 的 Blob URL 或共用存取簽章（SAS）提供給裝置更新 API。 如果使用 SAS，請務必提供三個小時以上的到期時間範圍

提示

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

• AzCopy
• Azure 儲存體總管

後續步驟

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