你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az iot ops asset endpoint
注意
此参考是 Azure CLI(版本 2.53.0 或更高版本)的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops 资产终结点 命令时自动安装。 详细了解扩展。
命令组“iot ops”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
管理资产终结点配置文件。
命令
名称 | 说明 | 类型 | Status |
---|---|---|---|
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]
[--cg]
[--cl]
[--clg]
[--cls]
[--cluster]
[--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}}'
必需参数
资产终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
目标地址。 必须是有效的本地地址。
可选参数
连接类型的其他配置(例如:OPC UA、Modbus、ONVIF)。
与终结点关联的证书对应的空格分隔键=值对。 支持以下键值: secret
(必需)、 thumbprint
(必需)、 password
.--cert 可以使用 1 次或多次。 查看有关完整参数用法的帮助示例。
身份验证中使用的证书参考。 尚不支持这种用户身份验证方法。
群集的资源组。
用于将资产终结点与群集关联的自定义位置。
自定义位置的资源组。
自定义位置的订阅 ID。
要与之关联的资产的群集。
群集的订阅 ID。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
身份验证中使用的密码参考。
资产终结点资源标记。 采用以下格式的键值对中的属性包:a=b c=d。
身份验证中使用的用户名参考。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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}
必需参数
资产终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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}
可选参数
连接类型的其他配置(例如:OPC UA、Modbus、ONVIF)。
身份验证模式。
用于将资产终结点与群集关联的自定义位置。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
目标地址。 必须是有效的本地地址。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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}
必需参数
资产终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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}}'
必需参数
资产终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
连接类型的其他配置(例如:OPC UA、Modbus、ONVIF)。
身份验证模式。
身份验证中使用的证书参考。 尚不支持这种用户身份验证方法。
身份验证中使用的密码参考。
目标地址。 必须是有效的本地地址。
资产终结点资源标记。 采用以下格式的键值对中的属性包:a=b c=d。
身份验证中使用的用户名参考。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。