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

az iot ops broker listener

参考

注释

此参考是 Azure CLI（版本 2.53.0 或更高版本）的 azure-iot-ops 扩展的一部分。该扩展将在首次运行 az iot ops broker 侦听器 命令时自动安装。了解更多关于扩展的相关信息。

Mqtt 代理侦听器管理。

命令

名称	说明	类型	Status
az iot ops broker listener apply	创建或替换 mqtt Broker 侦听器服务。	扩展	乔治亚州
az iot ops broker listener delete	删除 mqtt 中转站侦听器。	扩展	乔治亚州
az iot ops broker listener list	列出与代理关联的 mqtt 中转站侦听器。	扩展	乔治亚州
az iot ops broker listener port	Mqtt 代理侦听器端口作。	扩展	乔治亚州
az iot ops broker listener port add	将 tcp 端口配置添加到 mqtt 中转站侦听器服务。	扩展	乔治亚州
az iot ops broker listener port remove	从 mqtt 代理侦听器服务中删除 tcp 端口配置。	扩展	乔治亚州
az iot ops broker listener show	显示 mqtt 中转站侦听器的详细信息。	扩展	乔治亚州

az iot ops broker listener apply

创建或替换 mqtt Broker 侦听器服务。

配置文件格式的示例如下所示：

{
  "serviceType": "LoadBalancer",
  "ports": [
      {
          "port": 1883,
          "protocol": "Mqtt"
      },
      {
          "authenticationRef": "default",
          "port": 8883,
          "protocol": "Mqtt",
          "tls": {
              "mode": "Automatic",
              "certManagerCertificateSpec": {
                  "issuerRef": {
                      "name": "azure-iot-operations-aio-certificate-issuer",
                      "kind": "ClusterIssuer",
                      "group": "cert-manager.io"
                  }
              }
          }
      }
  ]
}

在应用上述内容时，将使用两个端口配置创建或替换目标侦听器。

az iot ops broker listener apply --config-file
                                 --instance
                                 --name
                                 --resource-group
                                 [--broker]

示例

使用配置文件为默认中转站创建或替换侦听器。

az iot ops broker listener apply -n listener --in myinstance -g myresourcegroup --config-file /path/to/listener/config.json

必需参数

--config-file

包含 json 格式的资源属性的配置文件的路径。配置文件应包含与资源的 ARM 表示形式兼容的属性的对象。该对象直接与 ARM 资源的“properties：{}”相关联。

--instance -i

IoT 操作实例名称。

--name -n

侦听器名称。

--resource-group -g

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

可选参数

--broker -b

代理名称。

默认值: default

全局参数

--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 broker listener delete

删除 mqtt 中转站侦听器。

az iot ops broker listener delete --instance
                                  --name
                                  --resource-group
                                  [--broker]
                                  [--yes {false, true}]

示例

删除与默认代理关联的 mqtt 中转站侦听器。

az iot ops broker listener delete -n listener --in myinstance -g myresourcegroup

与前面的示例相同，但跳过确认提示。

az iot ops broker listener delete -n listener --in myinstance -g myresourcegroup -y

必需参数

--instance -i

IoT 操作实例名称。

--name -n

侦听器名称。

--resource-group -g

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

可选参数

--broker -b

代理名称。

默认值: default

--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 broker listener list

列出与代理关联的 mqtt 中转站侦听器。

az iot ops broker listener list --instance
                                --resource-group
                                [--broker]

示例

枚举与默认代理关联的所有 mqtt 中转站侦听器。

az iot ops broker listener list --in myinstance -g myresourcegroup

必需参数

--instance -i

IoT 操作实例名称。

--resource-group -g

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

可选参数

--broker -b

代理名称。

默认值: default

全局参数

--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 broker listener show

显示 mqtt 中转站侦听器的详细信息。

az iot ops broker listener show --instance
                                --name
                                --resource-group
                                [--broker]

示例

显示与默认代理关联的默认侦听器的详细信息。

az iot ops broker listener show -n default --in myinstance -g myresourcegroup

必需参数

--instance -i

IoT 操作实例名称。

--name -n

侦听器名称。

--resource-group -g

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

可选参数

--broker -b

代理名称。

默认值: default

全局参数

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

命令

az iot ops broker listener apply

示例

必需参数

可选参数

az iot ops broker listener delete

示例

必需参数

可选参数

az iot ops broker listener list

示例

必需参数

可选参数

az iot ops broker listener show

示例

必需参数

可选参数