通过

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

az iot ops asset endpoint create

  • 参考

注意

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

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

命令

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

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

 扩展 荒废的
az iot ops asset endpoint create onvif

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

 扩展 荒废的
az iot ops asset endpoint create opcua

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

 扩展 加语

az iot ops asset endpoint create custom

已放弃

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

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

az iot ops asset endpoint create custom --endpoint-type
                                        --instance
                                        --name
                                        --resource-group
                                        --ta
                                        [--ac]
                                        [--cert-ref]
                                        [--cr]
                                        [--ig]
                                        [--instance-subscription]
                                        [--location]
                                        [--pass-ref]
                                        [--pr]
                                        [--tags]
                                        [--ur]
                                        [--user-ref]

示例

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

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat

使用不同资源组中的给定实例（但相同的订阅）创建具有用户名-密码用户身份验证的资产终结点。 附加配置以内联 json 的形式提供。

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --username-ref rest-server-auth-creds/username --password-ref rest-server-auth-creds/password --additional-config addition_configuration.json

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

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --certificate-ref mycertificate.pem

使用同一资源组中的给定实例创建具有匿名用户身份验证的资产终结点。 内联内容是 bash 语法示例。 有关更多示例，请参阅 https://aka.ms/inline-json-examples

az iot ops asset endpoint create custom --name myprofile -g myresourcegroup --instance myinstance --target-address http://rest-server-service.azure-iot-operations.svc.cluster.local:80 --endpoint-type rest-thermostat --additional-config '{"displayName": "myconnector", "maxItems": 100}'

必需参数

--endpoint-type --et

连接器的终结点配置文件类型。

--instance

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

--name -n

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

--resource-group -g

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

--ta --target-address

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

可选参数

--ac --additional-config

包含或内联 json 的文件路径，用于其他配置。

--cert-ref --certificate-ref

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

--cr
已放弃

选项“--cr”已弃用，将在将来的版本中删除。 请改用“--cert-ref”。

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

--ig --instance-resource-group

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

--instance-subscription --is
已放弃

参数“instance_subscription”已弃用，将在将来的版本中删除。

实例订阅 ID。如果未提供，将使用资产终结点配置文件订阅 ID。

--location -l

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

--pass-ref --password-ref

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

--pr
已放弃

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

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

--tags

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

--ur --username-reference
已放弃

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

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

--user-ref --username-ref

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

全局参数
--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 create onvif

已放弃

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

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

Onvif 连接器尚不支持证书身份验证。

有关如何创建 Onvif 连接器的详细信息，请参阅 https://aka.ms/onvif-quickstart。

az iot ops asset endpoint create onvif --instance
                                       --name
                                       --resource-group
                                       --ta
                                       [--cert-ref]
                                       [--cr]
                                       [--ig]
                                       [--instance-subscription]
                                       [--location]
                                       [--pass-ref]
                                       [--pr]
                                       [--tags]
                                       [--ur]
                                       [--user-ref]

示例

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

az iot ops asset endpoint create onvif --name myprofile -g myresourcegroup --instance myinstance --target-address http://onvif-rtsp-simulator:8000

使用不同资源组中的给定实例（但相同的订阅）创建具有用户名-密码用户身份验证的资产终结点。

az iot ops asset endpoint create onvif --name myprofile -g myresourcegroup --instance myinstance --instance-resource-group myinstanceresourcegroup --target-address http://onvif-rtsp-simulator:8000 --username-ref rest-server-auth-creds/username --password-ref rest-server-auth-creds/password

必需参数

--instance

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

--name -n

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

--resource-group -g

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

--ta --target-address

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

可选参数

--cert-ref --certificate-ref

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

--cr
已放弃

选项“--cr”已弃用，将在将来的版本中删除。 请改用“--cert-ref”。

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

--ig --instance-resource-group

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

--instance-subscription --is
已放弃

参数“instance_subscription”已弃用，将在将来的版本中删除。

实例订阅 ID。如果未提供，将使用资产终结点配置文件订阅 ID。

--location -l

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

--pass-ref --password-ref

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

--pr
已放弃

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

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

--tags

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

--ur --username-reference
已放弃

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

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

--user-ref --username-ref

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

全局参数
--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 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
                                       [--accept-untrusted-certs {false, true}]
                                       [--app]
                                       [--cert-ref]
                                       [--default-publishing-int]
                                       [--default-queue-size]
                                       [--default-sampling-int]
                                       [--ig]
                                       [--instance-subscription]
                                       [--ka]
                                       [--location]
                                       [--pass-ref]
                                       [--pr]
                                       [--rad {false, true}]
                                       [--security-mode {none, sign, signAndEncrypt}]
                                       [--security-policy {Aes128_Sha256_RsaOaep, Aes256_Sha256_RsaPss, Basic128Rsa15, Basic256, Basic256Sha256, none}]
                                       [--session-keep-alive]
                                       [--session-reconnect-backoff]
                                       [--session-reconnect-period]
                                       [--session-timeout]
                                       [--slt]
                                       [--smi]
                                       [--tags]
                                       [--ur]
                                       [--user-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

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

可选参数

--accept-untrusted-certs --auc

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

接受的值: false, true
--app --application

应用程序名称。 将用作连接器生成的任何证书的主题。

--cert-ref --cert-ref --certificate-ref --cr
已放弃

参数“certificate_reference”已弃用，将在将来的版本中删除。

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

--default-publishing-int --dpi

默认发布间隔（以毫秒为单位）。 最小值：-1。 建议：1000。

--default-queue-size --dqs

默认队列大小。 最小值：0。 建议：1.

--default-sampling-int --dsi

默认采样间隔（以毫秒为单位）。 最小值：-1。 建议：1000。

--ig --instance-resource-group

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

--instance-subscription --is
已放弃

参数“instance_subscription”已弃用，将在将来的版本中删除。

实例订阅 ID。如果未提供，将使用资产终结点配置文件订阅 ID。

--ka --keep-alive

发送保持活动发布响应的时间（以毫秒为单位）。 最小值：0。 建议：10000。

--location -l

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

--pass-ref --password-ref

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

--pr
已放弃

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

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

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

会话保持活动质询的发送时间（以毫秒为单位），以检测连接问题。 最小值：0。 建议：10000。

--session-reconnect-backoff --srb

会话重新连接指数回退（以毫秒为单位）。 最小值：-1。 建议：10000。

--session-reconnect-period --srp

会话重新连接周期（以毫秒为单位）。 最小值：0。 建议：2000。

--session-timeout --st

会话超时（以毫秒为单位）。 最小值：0。 建议：60000。

--slt --subscription-life-time

连接器为订阅创建的项的生存时间（以毫秒为单位）。 最小值：0。 建议：60000。

--smi --subscription-max-items

连接器可以为订阅创建的最大项数。 最小值：1。 建议：1000。

--tags

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

--ur --username-reference
已放弃

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

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

--user-ref --username-ref

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

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