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

az iot ops asset endpoint

注意

此参考是 Azure CLI（版本 2.46.0 或更高版本）的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops 资产终结点 命令时自动安装。 详细了解扩展。

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

管理资产终结点配置文件。

命令

名称	说明	类型	状态
az iot ops asset endpoint certificate	管理资产终结点中拥有的证书。	扩展	预览
az iot ops asset endpoint certificate add	将拥有的证书添加到资产终结点。	扩展	预览
az iot ops asset endpoint certificate list	列出资产终结点中拥有的证书。	扩展	预览
az iot ops asset endpoint certificate remove	删除资产终结点中拥有的证书。	扩展	预览
az iot ops asset endpoint create	创建资产终结点。	扩展	预览
az iot ops asset endpoint delete	删除资产终结点。	扩展	预览
az iot ops asset endpoint query	查询资源图中的资产终结点。	扩展	预览
az iot ops asset endpoint show	显示资产终结点。	扩展	预览
az iot ops asset endpoint update	更新资产终结点。	扩展	预览

az iot ops asset endpoint create

预览

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

创建资产终结点。

必须提供自定义位置或群集名称。 此命令将检查关联的自定义位置和群集的存在，并确保两者都使用 microsoft.deviceregistry.assets 扩展正确设置。

Azure IoT OPC UA Broker（预览版）对其自身和其连接到的 OPC UA 服务器之间的所有安全通道使用相同的客户端证书。

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cl]
                                 [--clrg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-resource-group]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

示例

使用给定的自定义位置创建具有匿名用户身份验证的资产终结点。

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

使用自定义位置的给定自定义位置和资源组创建具有匿名用户身份验证的资产终结点。 如果订阅中有多个具有相同名称的自定义位置，则必须包含资源组。

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

使用用户名-密码用户身份验证创建资产终结点，并使用预填充值预配置自有证书。用户名和密码引用是通过 Azure Keyvault 容器存储接口驱动程序设置的。

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

使用用户名-密码用户身份验证和预填充值的其他配置（powershell 语法示例）创建资产终结点。

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

使用用户名-密码用户身份验证和预填充值的其他配置（cmd 语法示例）创建资产终结点。

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

使用用户名和密码用户身份验证创建资产终结点，并使用预填充值创建其他配置（bash 语法示例）。

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

必需参数

--name -n

资产终结点名称。

--resource-group -g

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

--ta --target-address

目标地址。 必须是有效的本地地址。

可选参数

--ac --additional-config

连接类型的其他配置（例如：OPC UA、Modbus、ONVIF）。

--cert

与终结点关联的证书对应的空格分隔键=值对。 支持以下键值： secret （必需）、 thumbprint （必需）、 password.--cert 可以使用 1 次或多次。 查看有关完整参数用法的帮助示例。

--cert-ref --certificate-ref --cr

身份验证中使用的证书参考。 尚不支持这种用户身份验证方法。

--cl --custom-location

用于将资产终结点与群集关联的自定义位置。

--clrg --custom-location-resource-group

自定义位置的资源组。

--cls --custom-location-subscription

自定义位置的订阅 ID。

--cluster -c

要与之关联的资产的群集。

--cluster-resource-group --crg

群集的资源组。

--cluster-subscription --cs

群集的订阅 ID。

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--password-ref --pr

身份验证中使用的密码参考。

--tags

资产终结点资源标记。 采用以下格式的键值对中的属性包：a=b c=d。

--ur --username-reference

身份验证中使用的用户名参考。

全局参数

--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 asset endpoint delete

预览

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

删除资产终结点。

az iot ops asset endpoint delete --name
                                 --resource-group

示例

删除资产终结点。

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

必需参数

--name -n

资产终结点名称。

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

az iot ops asset endpoint query

预览

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

查询资源图中的资产终结点。

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

示例

查询导致匿名身份验证的资产终结点。

az iot ops asset endpoint query --authentication-mode Anonymous

查询具有给定目标地址和自定义位置的资产终结点。

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

可选参数

--ac --additional-config

连接类型的其他配置（例如：OPC UA、Modbus、ONVIF）。

--am --authentication-mode

身份验证模式。

--cl --custom-location

用于将资产终结点与群集关联的自定义位置。

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

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

--ta --target-address

目标地址。 必须是有效的本地地址。

全局参数

--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 asset endpoint show

预览

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

显示资产终结点。

az iot ops asset endpoint show --name
                               --resource-group

示例

显示资产终结点的详细信息。

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

必需参数

--name -n

资产终结点名称。

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

az iot ops asset endpoint update

预览

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

更新资产终结点。

若要更新拥有的证书，请使用命令组 az iot ops asset endpoint certificate。

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

示例

更新资产终结点的身份验证模式以使用匿名用户身份验证。

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

使用预填充的值更新资产终结点的用户名和密码引用。 这会将身份验证模式转换为用户名-密码（如果尚未这样做）。

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

使用预填充值更新资产终结点的目标地址和其他配置（powershell 语法示例）。

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

使用预填充值更新资产终结点的目标地址和其他配置（cmd 语法示例）。

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

使用预填充值更新资产终结点的目标地址和其他配置（bash 语法示例）。

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

必需参数

--name -n

资产终结点名称。

--resource-group -g

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

可选参数

--ac --additional-config

连接类型的其他配置（例如：OPC UA、Modbus、ONVIF）。

--am --authentication-mode

身份验证模式。

--cert-ref --certificate-ref --cr

身份验证中使用的证书参考。 尚不支持这种用户身份验证方法。

--password-ref --pr

身份验证中使用的密码参考。

--ta --target-address

目标地址。 必须是有效的本地地址。

--tags

资产终结点资源标记。 采用以下格式的键值对中的属性包：a=b c=d。

--ur --username-reference

身份验证中使用的用户名参考。

全局参数

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