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

az iot ops asset endpoint create

Note

This reference is part of the azure-iot-ops extension for the Azure CLI (version 2.62.0 or higher). 该扩展将在首次运行 az iot ops asset endpoint create 命令时自动安装。 Learn more about extensions.

创建资产终结点配置文件。

命令

名称 说明 类型 Status
az iot ops asset endpoint create opcua

为 OPCUA 连接器创建资产终结点配置文件。

Extension GA

az iot ops asset endpoint create opcua

为 OPCUA 连接器创建资产终结点配置文件。

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

对于 OPC UA 连接器参数,值为 -1 表示不会使用参数(例如:--session-reconnect-backoff -1 表示不应使用指数退避)。 值为 0 表示使用最快的实际速率(例如:--default-sampling-int 0 表示使用服务器可能最快的采样间隔)。

有关如何为 OPC UA 连接器配置资产终结点的详细信息,请参阅 https://aka.ms/opcua-quickstart

az iot ops asset endpoint create opcua --instance
                                       --name
                                       --resource-group
                                       --ta --target-address
                                       [--accept-untrusted-certs --auc {false, true}]
                                       [--app --application]
                                       [--default-publishing-int --dpi]
                                       [--default-queue-size --dqs]
                                       [--default-sampling-int --dsi]
                                       [--ig --instance-resource-group]
                                       [--ka --keep-alive]
                                       [--location]
                                       [--pass-ref --password-ref]
                                       [--pr]
                                       [--rad --run-asset-discovery {false, true}]
                                       [--security-mode --sm {none, sign, signAndEncrypt}]
                                       [--security-policy --sp {Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss, Basic128Rsa15, Basic256, Basic256Sha256, none}]
                                       [--session-keep-alive --ska]
                                       [--session-reconnect-backoff --srb]
                                       [--session-reconnect-period --srp]
                                       [--session-timeout --st]
                                       [--slt --subscription-life-time]
                                       [--smi --subscription-max-items]
                                       [--tags]
                                       [--ur --username-reference]
                                       [--user-ref --username-ref]

示例

使用同一资源组中的给定实例创建具有匿名用户身份验证的资产终结点。

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000

使用不同资源组中的给定实例(但相同的订阅)创建具有匿名用户身份验证的资产终结点。 请注意,如果数字操作体验位于与实例不同的订阅中,则可能不会显示资产终结点配置文件。

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address opc.tcp://opcplc-000000:50000

使用同一资源组中的给定实例创建具有用户名-密码用户身份验证的资产终结点。

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000 --username-ref myusername --password-ref mypassword

使用同一资源组中的给定实例为 OPCUA 配置创建具有匿名用户身份验证和建议值的资产终结点。 请注意,若要成功使用连接器,需要部署 OPC PLC 服务,并且目标地址必须指向该服务。 如果 OPC PLC 服务与 IoT Ops 位于同一群集和命名空间中,则目标地址的格式应设置为“opc.tcp://{opc-plc-service-name}:{service-port}”。如果 OPC PLC 服务位于与 IoT Ops 相同的群集中,但与 IoT Ops 位于不同的命名空间中,请包含服务命名空间,例如“opc.tcp://{opc-plc-service-name}”。{service-namespace}:{service-port}' 有关详细信息,请参阅 aka.ms/opcua-quickstart

az iot ops asset endpoint create opcua --name myprofile -g myresourcegroup --instance myinstance --target-address opc.tcp://opcplc-000000:50000 --accept-untrusted-certs --application myopcuaconnector --default-publishing-int 1000 --default-queue-size 1 --default-sampling-int 1000 --keep-alive 10000 --run-asset-discovery --security-mode sign --security-policy Basic256 --session-keep-alive 10000 --session-reconnect-backoff 10000 --session-reconnect-period 2000 --session-timeout 60000 --subscription-life-time 60000 --subscription-max-items 1000

必需参数

--instance

要与所创建资产关联的实例名称。

--name -n

资产终结点配置文件名称。

--resource-group -g

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

--ta --target-address

Target Address. 必须是遵循 opc.tcp 协议的有效本地地址。

可选参数

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

--accept-untrusted-certs --auc

用于启用自动接受不受信任的服务器证书的标志。

属性
Parameter group: Connector Arguments
接受的值: false, true
--app --application

Application name. 将用作连接器生成的任何证书的主题。

属性
Parameter group: Connector Arguments
--default-publishing-int --dpi

默认发布间隔(以毫秒为单位)。 Minimum: -1. Recommended: 1000.

属性
Parameter group: Connector Arguments
--default-queue-size --dqs

默认队列大小。 Minimum: 0. Recommended: 1.

属性
Parameter group: Connector Arguments
--default-sampling-int --dsi

默认采样间隔(以毫秒为单位)。 Minimum: -1. Recommended: 1000.

属性
Parameter group: Connector Arguments
--ig --instance-resource-group

实例资源组。 如果未提供,将使用资产终结点配置文件资源组。

--ka --keep-alive

发送保持活动发布响应的时间(以毫秒为单位)。 Minimum: 0. Recommended: 10000.

属性
Parameter group: Connector Arguments
--location -l

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

--pass-ref --password-ref

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

属性
Parameter group: Authentication Arguments
--pr
已放弃

选项“--pr”已弃用,将在将来的版本中删除。 请改用“--pass-ref”。

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

属性
Parameter group: Authentication Arguments
--rad --run-asset-discovery

用于确定是否应运行资产发现的标志。

属性
Parameter group: Connector Arguments
接受的值: false, true
--security-mode --sm

Security mode.

属性
Parameter group: Connector Arguments
接受的值: none, sign, signAndEncrypt
--security-policy --sp

Security policy.

属性
Parameter group: Connector Arguments
接受的值: Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss, Basic128Rsa15, Basic256, Basic256Sha256, none
--session-keep-alive --ska

会话保持活动质询的发送时间(以毫秒为单位),以检测连接问题。 Minimum: 0. Recommended: 10000.

属性
Parameter group: Connector Arguments
--session-reconnect-backoff --srb

会话重新连接指数回退(以毫秒为单位)。 Minimum: -1. Recommended: 10000.

属性
Parameter group: Connector Arguments
--session-reconnect-period --srp

会话重新连接周期(以毫秒为单位)。 Minimum: 0. Recommended: 2000.

属性
Parameter group: Connector Arguments
--session-timeout --st

会话超时(以毫秒为单位)。 Minimum: 0. Recommended: 60000.

属性
Parameter group: Connector Arguments
--slt --subscription-life-time

连接器为订阅创建的项的生存时间(以毫秒为单位)。 Minimum: 0. Recommended: 60000.

属性
Parameter group: Connector Arguments
--smi --subscription-max-items

连接器可以为订阅创建的最大项数。 Minimum: 1. Recommended: 1000.

属性
Parameter group: Connector Arguments
--tags

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

--ur --username-reference
已放弃

选项“--username-reference”已弃用,将在将来的版本中删除。 请改用“--user-ref”。

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

属性
Parameter group: Authentication Arguments
--user-ref --username-ref

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

属性
Parameter group: Authentication Arguments
全局参数
--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