将更新导入到 IoT 中心设备更新：架构和其他信息

如果要将更新导入到 IoT 中心的设备更新中，请务必先查看 概念 和 作指南 。 如果对导入清单架构的详细信息或有关 API 权限的信息感兴趣，请参阅下文。

导入清单 JSON 架构托管在 SchemaStore.org。

图式

不允许使用其他属性。

updateId 对象

updateID 对象是每个更新的唯一标识符。

不允许使用其他属性。

例如：

{
  "updateId": {
    "provider": "Contoso",
    "name": "Toaster",
    "version": "1.0"
  }
}

兼容性对象

兼容性对象描述此更新与之兼容的设备的属性。

• 类型： object
• 最小属性： 1
• 最大属性： 5

每个属性都是字符串类型的名称值对。

• 最小属性名称长度： 1
• 最大属性名称长度： 32
• 属性值的最小长度：1
• 最大属性值长度： 64

同一组完全相同的兼容性属性不能与多个更新提供程序和名称组合一起使用。

例如：

{
  "compatibility": [
    {
      "deviceManufacturer": "Contoso",
      "deviceModel": "Toaster"
    }
  ]
}

指令对象

指令对象提供更新安装说明。 指令对象包含要执行的步骤列表。 步骤可以是执行的代码，也可以是指向其他更新的指针。

不允许使用其他属性。

例如：

{
  "instructions": {
    "steps": [
      {
        "type": "inline",
        ...
      },
      {
        "type": "reference",
        ...
      }
    ]
  }
}

inlineStep 对象

内联步骤对象是一个进行代码执行的安装指令步骤。

不允许使用其他属性。

例如：

{
  "steps": [
    {
      "description": "pre-install script",
      "handler": "microsoft/script:1",
      "handlerProperties": {
        "arguments": "--pre-install"
      },
      "files": [
        "configure.sh"
      ]
    }
  ]
}

referenceStep 对象

引用步骤对象是一个安装说明步骤，用于安装另外的更新。

不允许使用其他属性。

例如：

{
  "steps": [
    {
      "type": "reference",
      "updateId": {
        "provider": "Contoso",
        "name": "Toaster.HeatingElement",
        "version": "1.0"
      }
    }
  ]
}

文件对象

文件对象是更新有效负载文件，例如二进制文件、固件、脚本等。每个文件对象在更新中必须是唯一的。

不允许使用其他属性。

例如：

{
  "files": [
    {
      "filename": "configure.sh",
      "sizeInBytes": 7558,
      "hashes": {...}
    }
  ]
}

fileHashes 对象

使用 Base64 编码的文件哈希，其中算法名称作为键。 必须至少指定 SHA-256 算法，并且代理支持时可以指定其他算法。 有关如何正确计算哈希的示例，请参阅 AduUpdate.psm1 脚本中的 Get-AduFileHashes 函数。

允许其他属性。

例如：

{
  "hashes": {
    "sha256": "/CD7Sn6fiknWa3NgcFjGlJ+ccA81s1QAXX4oo5GHiFA="
  }
}

后续步骤

详细了解 导入概念。

如果已准备就绪，请尝试 导入 How-To 指南，该指南将逐步引导你完成导入过程。