將更新匯入 IoT 中樞的裝置更新：結構描述和其他資訊

如果您想要將更新匯入 IoT 中樞裝置更新，請務必先檢閱概念和操作指南。 如果您對匯入資訊清單結構描述本身的詳細資料感興趣，請參閱下方。

匯入資訊清單 JSON 結構描述會裝載於 SchemaStore.org。

結構描述

不允許其他屬性。

updateId 物件

updateID 物件是每個更新的唯一識別碼。

不允許其他屬性。

例如：

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

相容性物件

相容性物件會描述此更新與其相容的裝置屬性。

• 類型：object
• 屬性下限：1
• 屬性上限：5

每個屬性都是類型字串的名稱-值組。

• 屬性名稱長度下限：1
• 屬性名稱長度上限：32
• 屬性值長度下限：1
• 屬性值長度上限：64

同一組完全相同的相容性屬性不能與一個以上的提供者及名稱組合搭配使用。

例如：

{
  "compatibility": [
    {
      "manufacturer": "Contoso",
      "model": "Toaster"
    }
  ]
}

instructions 物件

instructions 物件會提供更新安裝指示。 instructions 物件包含要執行的步驟清單。 步驟可以是要執行的程式碼或另一個更新的指標。

不允許其他屬性。

例如：

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

inlineStep 物件

inline 步驟物件是執行程式碼執行的安裝指令步驟。

不允許其他屬性。

例如：

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

referenceStep 物件

reference 步驟物件是會安裝另一個更新的安裝指示步驟。

不允許其他屬性。

例如：

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

file 物件

file 物件是更新承載檔案，例如二進位檔、韌體、指令碼等。每個檔案物件在更新內都必須是唯一的。

不允許其他屬性。

例如：

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

fileHashes 物件

Base64 編碼的檔案雜湊會使用演算法名稱作為索引鍵。 至少必須指定 SHA-256 演算法，而如果代理程式支援，則可以指定其他的演算法。 如需如何正確計算雜湊的範例，請參閱 AduUpdate.psm1 指令碼中的 Get-AduFileHashes 函式。

允許其他屬性。

例如：

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

relatedFiles 物件

一或多個主要承載檔案的相關檔案集合。

允許其他屬性。

例如：

"relatedFiles": [
  {
    "filename": "in1_in2_deltaupdate.dat",
    "sizeInBytes": 102910752,
    "hashes": {
      "sha256": "2MIldV8LkdKenjJasgTHuYi+apgtNQ9FeL2xsV3ikHY="
    },
    "properties": {
      "microsoft.sourceFileHashAlgorithm": "sha256",
      "microsoft.sourceFileHash": "YmFYwnEUddq2nZsBAn5v7gCRKdHx+TUntMz5tLwU+24="
    }
  }
],

如需詳細資訊，請參閱使用相關的檔案功能來參考多個更新檔案。

downloadHandler 物件

指定如何處理任何相關的檔案。

部允許其他屬性。

例如：

"downloadHandler": {
  "id": "microsoft/delta:1"
}

下一步

深入了解匯入概念。

如果您已準備就緒，請嘗試匯入操作指南，其將逐步引導您完成匯入程序。