az iot hub certificate root-authority

Note

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

此命令组已弃用，将在将来的版本中删除。

管理IoT 中心实例的证书根颁发机构。

命令

名称	说明	类型	Status
az iot hub certificate root-authority set	将IoT 中心实例的证书根颁发机构设置为特定版本。	Extension	Deprecated
az iot hub certificate root-authority show	显示IoT 中心实例的当前证书根颁发机构。	Extension	Deprecated

az iot hub certificate root-authority set

已放弃

此命令已隐式弃用，因为命令组“iot 中心证书根颁发机构”已弃用，将在将来的版本中删除。

将IoT 中心实例的证书根颁发机构设置为特定版本。

将此资源转换为 DigiCert Global G2 根（v2）上的证书，或还原到 Baltimore 根（v1）。 在进行此转换之前，请确保更新所有设备以包含IoT 中心将转换为的根的公共部分。 设备将使用新根断开连接并重新连接。 建议监视当前连接，但用户定义的指标可能更适合你的情况。

az iot hub certificate root-authority set --cav --certificate-authority {v1, v2}
                                          --hub-name
                                          [--resource-group]
                                          [--yes {false, true}]

示例

将目标 IoT 中心证书颁发机构转换为 Digicert。

az iot hub certificate root-authority set --hub-name {iothub_name} --certificate-authority v2

将目标 IoT 中心证书颁发机构还原到 Baltimore。

az iot hub certificate root-authority set --hub-name {iothub_name} --certificate-authority v1

必需参数

--cav --certificate-authority

证书颁发机构版本。 v1 表示巴尔的摩 CA，v2 表示 Digicert CA。

属性	值
接受的值:	v1, v2

--hub-name -n

IoT 中心名称。 如果未提供 --login，则为必需。

属性	值
Parameter group:	IoT Hub Identifier Arguments

可选参数

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

--resource-group -g

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

--yes -y

跳过用户提示。 指示接受操作。 主要用于自动化方案。 Default: false.

属性	值
默认值:	False
接受的值:	false, true

全局参数

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

az iot hub certificate root-authority show

已放弃

此命令已隐式弃用，因为命令组“iot 中心证书根颁发机构”已弃用，将在将来的版本中删除。

显示IoT 中心实例的当前证书根颁发机构。

az iot hub certificate root-authority show --hub-name
                                           [--resource-group]

示例

显示目标 IoT 中心证书颁发机构。

az iot hub certificate root-authority show --hub-name {iothub_name}

必需参数

--hub-name -n

IoT 中心名称。 如果未提供 --login，则为必需。

属性	值
Parameter group:	IoT Hub Identifier Arguments

可选参数

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

--resource-group -g

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

全局参数

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