Share via

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az iot du update init

  • 预览
  • 参考

注意

此参考是 Azure CLI（版本 2.37.0 或更高版本）的 azure-iot 扩展的一部分。 该扩展将在首次运行 az iot du update init 命令时自动安装。 详细了解扩展。

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

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

命令

名称 说明 类型 状态
az iot du update init v5

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

 扩展 预览

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.providerupdateId.name和 updateId.versiondescription。 支持以下内联步骤键：（例如： 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

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

--verbose

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