你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将更新导入到 Device Update for IoT Hub

了解如何获取新的更新并将其导入 Device Update for IoT Hub。 如果尚未导入，请务必查看关键导入概念以及如何准备要导入的更新。

先决条件

• 访问已启用 Device Update for IoT Hub 的 IoT 中心。
• 为 IoT 中心内的设备更新预配的 IoT 设备（或模拟器）。
• 按照准备要导入到 Device Update for IoT Hub 的更新中的步骤，为更新文件创建导入清单。

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 导入更新。 还可以改用 Device Update for IoT Hub API 来导入更新。

若要导入更新，请先上传更新文件并将清单导入到 Azure 存储容器。 然后，将更新从 Azure 存储导入 Device Update for IoT Hub，该更新将存储在其中，以便部署到设备。

Azure 门户

1. 在 Azure 门户中，导航到具有设备更新的 IoT 中心。

2. 在页面的左侧，选择“设备管理”下的“更新”。

   

3. 从屏幕顶部的选项卡列表中选择“更新”选项卡。

   

4. 在“可用更新”标题下方选择“导入新的更新”。

   

5. 选择“+ 从存储容器中选择”。 将显示存储帐户 UI。 选择现有帐户，或使用“+ 存储帐户”创建一个帐户。 此帐户用于容器暂存要导入的更新。 该帐户不应同时启用公共终结点和专用终结点。

   

6. 选择存储帐户后，系统将显示存储容器 UI。 选择现有容器，或者使用“+ 容器”创建一个容器。 此容器将用于暂存更新文件以供导入

   建议每次导入更新时都使用新容器。 始终使用新容器有助于避免意外地从以前的更新导入文件。 如果不使用新容器，请务必在完成此步骤之前删除现有容器中的任何文件。

   

7. 在容器中，选择“上传”。 将显示上传 UI。

   

8. 选择“上传 blob”标题下“文件”部分右侧的文件夹图标。 使用文件选取器导航到更新文件的位置并导入清单，然后依次选择所有文件和“打开”。 你可以按住 Shift 键并单击以选择多选文件。

   

9. 选择所有更新文件后，选择“上传”。

   

10. 选择上传的文件以指定要导入的文件。 然后选择“选择”按钮以返回到“导入更新”页。

    

11. 在“导入更新”页上，查看要导入的文件。 然后选择“导入更新”以启动导入过程。 要解决任何错误，请参阅代理更新故障排除。

    

12. 导入过程开始后，屏幕切换到“导入历史记录”部分。 选择“刷新”以查看进度，直到导入过程完成（具体取决于更新大小，这可能会在几分钟内完成，但可能需要更长时间）。

    

13. 当“状态”列指示导入成功时，选择“可用更新”标题。 现在应会在列表中看到导入的更新。

    

Azure CLI

az iot du update stage 命令处理导入更新的必要步骤，包括将更新文件上传到目标存储容器。 可选标志还允许此命令在准备好文件后自动导入文件。 否则，az iot du update import 命令将完成该过程。

stage 命令使用以下自变量：

• --account：设备更新帐户名称。
• --instance：Device Update 实例名称。
• --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 进行导入

还可以通过以下方式以编程方式导入更新：

• 将 Azure SDK 用于 .NET、Java、JavaScript 或 Python
• 使用导入更新 REST API
• 使用示例 PowerShell 模块
  • 需要 PowerShell 5 或更高版本（包括 Linux、macOS 和 Windows 安装）

注意

有关所需的 API 权限，请参阅设备更新用户角色和访问权限。

更新文件和导入清单必须上传到用于暂存的 Azure 存储 Blob 容器。 要导入暂存文件，请为专用 Blob 提供 Blob URL，或者设备更新 API 的共享访问签名 (SAS)。 如果使用 SAS，请确保提供三小时或更长过期时段

提示

要将大型更新文件上传到 Azure 存储 Blob 容器，可以使用以下方法之一来提高性能：

• AzCopy
• Azure 存储资源管理器

后续步骤

• 创建组
• 了解导入概念