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

az iot ops rsync

注释

此参考是 Azure CLI(版本 2.62.0 或更高版本)的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops rsync 命令时自动安装。 了解更多关于扩展的信息。

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

资源同步规则管理。

命令

名称 说明 类型 Status
az iot ops rsync disable

通过删除实例关联的资源同步规则来禁用云冻结边缘。

扩展 预览
az iot ops rsync enable

通过为实例创建资源同步规则,启用边缘到云冻结。

扩展 预览
az iot ops rsync list

列出与实例关联的资源同步规则。

扩展 预览

az iot ops rsync disable

预览

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

通过删除实例关联的资源同步规则来禁用云冻结边缘。

az iot ops rsync disable --instance
                         --resource-group
                         [--yes {false, true}]

示例

禁用目标实例的资源同步。

az iot ops rsync disable -n myinstance -g myresourcegroup

必需参数

--instance -i -n

IoT 操作实例名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

可选参数

--yes -y

在没有提示的情况下确认 [y]es。 适用于 CI 和自动化方案。

接受的值: false, true
全局参数
--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 获取完整的调试日志。

az iot ops rsync enable

预览

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

通过为实例创建资源同步规则,启用边缘到云冻结。

此作将创建两个资源同步规则。 一个用于 IoT作,一个用于设备注册表。 然后,它将在 K8 Bridge 服务主体和 IoT作实例自定义位置之间应用角色分配。

az iot ops rsync enable --instance
                        --resource-group
                        [--custom-role-id]
                        [--k8-bridge-sp-oid]
                        [--rule-adr-name]
                        [--rule-adr-pri]
                        [--rule-ops-name]
                        [--rule-ops-pri]
                        [--skip-ra {false, true}]
                        [--tags]

示例

为实例启用资源同步。

az iot ops rsync enable -n myinstance -g myresourcegroup

为实例启用资源同步,但跳过角色分配步骤。

az iot ops rsync enable -n myinstance -g myresourcegroup --skip-ra

为实例启用资源同步,并迅速提供 K8 Bridge 主体 OID。

az iot ops rsync enable -n myinstance -g myresourcegroup --k8-bridge-sp-oid $TENANT_K8_BRIDGE_SP_OID

使用某些自定义项为实例启用资源同步。

az iot ops rsync enable -n myinstance -g myresourcegroup --rule-adr-name myadrsync --rule-ops-name myopsync --rule-adr-pri 100 --rule-ops-pri 200

必需参数

--instance -i -n

IoT 操作实例名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

可选参数

--custom-role-id

完全限定的角色定义 ID 采用以下格式:/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}。

--k8-bridge-sp-oid

为自定义位置角色分配提供显式 K8 Bridge 服务主体 OID。 如果登录主体没有从 MS Graph 查询应用的权限,这非常有用。

--rule-adr-name

要为设备注册表创建的资源同步规则的所需名称。

--rule-adr-pri

要为设备注册表创建的资源同步规则的所需优先级。

--rule-ops-name

要为 IoT作创建的资源同步规则的所需名称。

--rule-ops-pri

要为 IoT作创建的资源同步规则的所需优先级。

--skip-ra

使用时,将跳过操作的角色分配步骤。

接受的值: false, true
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--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 获取完整的调试日志。

az iot ops rsync list

预览

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

列出与实例关联的资源同步规则。

az iot ops rsync list --instance
                      --resource-group

示例

列出与实例关联的资源同步规则。

az iot ops rsync list -n myinstance -g myresourcegroup

必需参数

--instance -i -n

IoT 操作实例名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

全局参数
--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 获取完整的调试日志。