共用方式為

az iot du update init

  • 預覽
  • 參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分（2.46.0 版或更高版本）。 擴充功能會在您第一次執行 az iot du update init 命令時自動安裝。 深入了解擴充功能。

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

匯入指令清單初始化的公用程式。

命令

名稱 Description 類型 狀態
az iot du update init v5

使用所需的狀態初始化 v5 匯入指令清單。

 副檔名 預覽​​

az iot du update init v5

預覽

命令群組 'iot du update init' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

使用所需的狀態初始化 v5 匯入指令清單。

此命令支援 v5 匯入指令清單的所有屬性。 請注意，和--file之間--step有位置敏感度，以及 --file 與 --related-file。 如需如何充分利用作業的詳細資訊，請檢閱範例和參數描述。

在這裡深入瞭解如何在不同的殼層中使用引號和逸出字元： https://aka.ms/aziotcli-json。

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

範例

初始化最小內容匯入資訊清單。 針對 『bash』 優化的內嵌 json。

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

初始化最小內容匯入資訊清單。 針對 『powershell』 優化的內嵌 json。

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

初始化最小內容匯入資訊清單。 針對 『cmd』 優化的內嵌 json。

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

初始化最小內容匯入資訊清單。 使用 json 的檔案輸入。

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

初始化不可部署的分葉更新，以在配套更新中參考。 針對 『bash』 優化的內嵌 json。

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

初始化參考分葉更新以及定義獨立步驟的配套更新。 使用命令接續來描述匯入指令清單區段的優化範例，針對 『bash』 優化。

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

必要參數

--compat

與此更新屬性對應的空格分隔索引鍵=值組與裝置的屬性相容。 通常用於定義製造商和型號等屬性。 --compat 可以使用 1 或多次。

--step

與 'instructions.steps' 元素屬性對應的空格分隔索引鍵=值組。 用戶端會根據提供的索引鍵值組，判斷步驟是否為內嵌或參考步驟。 如果可以滿足內嵌或參考步驟，則會優先處理參考步驟。 --file 的使用方式將會與最接近的內嵌 --step 專案相關聯，衍生 'files' 的值。 支援下列參考步驟金鑰：updateId.provider、 updateId.nameupdateId.version 和 description。 支援下列內嵌步驟密鑰： handler （例如：'microsoft/script：1' 或 'microsoft/swupdate：1' 或 'microsoft/apt：1'）， properties （代理程式將傳遞至處理程式的內嵌 json 物件），以及 description。 --step 可以使用 1 或多次。

--update-name

更新名稱做為 updateId 的元件。

--update-provider

更新提供者做為 updateId 的元件。

--update-version

更新版本做為 updateId 的元件。

選擇性參數

--description

匯入指令清單的描述。

--file

與 『files』 元素屬性對應的空格分隔索引鍵=值組。 如果提供 ,--file 專案可以包含最接近的 --related-file 專案。 支援下列索引鍵： path [必要] 更新檔案的本機檔案路徑（ downloadHandler 例如：'microsoft/delta：1'） 處理程式，以利用相關檔案來下載承載檔案， properties （代理程式將會傳遞至處理程式的內嵌 json 物件）。 --file 可以使用 1 或多次。

--is-deployable

指出更新是否可獨立部署。

接受的值: false, true
--no-validation

停用匯入指令清單內容的用戶端 JSON 架構驗證。

接受的值: false, true
--related-file

與 『files[*].relatedFiles』 元素屬性對應的空格分隔索引鍵=值組。 如果 --related-file 專案存在，則會與最接近的 --file 專案相關聯。 支援下列索引鍵： path [必要] 相關更新檔案的本機檔案路徑（ properties 傳遞至下載處理程式的內嵌 json 物件）。 --related-file 可以使用 1 或多次。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。