az iot du update init

  • 預覽
  • 參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分 （2.37.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 來取得完整偵錯記錄。