az iot du update init

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). 该扩展会在首次运行 az iot du update init 命令时自动安装。 Learn more about extensions.

此命令组处于预览状态，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

用于导入清单初始化的实用工具。

命令

名称	说明	类型	Status
az iot du update init v5	使用所需状态初始化 v5 导入清单。	Extension	Preview

az iot du update init v5

预览

命令组“iot du update init”处于预览状态，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

使用所需状态初始化 v5 导入清单。

此命令支持 v5 导入清单的所有属性。 请注意，在 --step 和 --file和/和 --file 之间 --related-file存在位置敏感度。 查看示例和参数说明，详细了解如何充分利用操作。

在此处阅读有关在不同 shell 中使用引号和转义字符的详细信息： 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 的用法将与最接近的内联条目相关联，从而派生“files”的值。 支持以下参考步骤键：updateId.provider、updateId.name、updateId.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 的组件。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False