Azure IoT Edge OPC Publisher 命令行参数详解

概述

Azure IoT Edge OPC Publisher 是一个工业物联网解决方案组件，用于将 OPC UA 服务器数据发布到 Azure IoT Hub。本文全面解析 OPC Publisher 版本 2.5 及以下版本的所有命令行参数配置，帮助开发者高效部署和使用该工具。

基本参数结构

OPC Publisher 的基本启动命令格式如下：

opcpublisher.exe <applicationname> [<iothubconnectionstring>] [<options>]

其中：

• applicationname：必需参数，指定 OPC UA 应用程序名称，该名称也用于在 IoT Hub 设备注册表中注册发布者
• iothubconnectionstring：可选参数，指定 IoT Hub 所有者连接字符串

环境变量配置

OPC Publisher 支持通过环境变量进行配置，这些变量会被命令行参数覆盖：

• _HUB_CS：设置 IoT Hub 所有者连接字符串
• _GW_LOGP：设置日志文件名
• _TPC_SP：设置受信任站点证书存储路径
• _GW_PNFP：设置发布配置文件名

核心功能参数详解

发布配置相关

• --pf/--publishfile：指定要发布的节点配置文件路径，默认为'/appdata/publishednodes.json'
• --tc/--telemetryconfigfile：遥测配置文件路径，默认为空
• --site：指定工作站点域名，会附加到发送到 IoT Hub 的遥测数据的'ApplicationURI'属性中

通信协议配置

• --ih/--iothubprotocol：指定与 IoT Hub 通信的协议，可选值包括：
  • Amqp
  • Http1
  • Amqp_WebSocket_Only
  • Amqp_Tcp_Only
  • Mqtt
  • Mqtt_WebSocket_Only
  • Mqtt_Tcp_Only

性能调优参数

• --mq/--monitoreditemqueuecapacity：监控项通知队列容量，默认8192
• --ms/--iothubmessagesize：发送到 IoT Hub 的最大消息大小，默认262144字节
• --si/--iothubsendinterval：遥测发送间隔（秒），0表示仅由消息大小控制

OPC UA 连接参数

• --oi/--opcsamplinginterval：默认采样间隔（毫秒），默认1000
• --op/--opcpublishinginterval：默认发布间隔（毫秒），默认0（由服务器决定）
• --ct/--createsessiontimeout：创建会话超时（秒），默认10

安全认证配置

• --aa/--autoaccept：自动信任所有连接的服务器
• --to/--trustowncert：自动将发布者证书放入受信任证书存储
• --at/--appcertstoretype：应用程序证书存储类型，可选Directory或X509Store

日志与诊断

• --lf/--logfile：日志文件路径，默认'./-publisher.log'
• --ll/--loglevel：日志级别，可选fatal/error/warn/info/debug/verbose
• --di/--diagnosticsinterval：诊断信息输出间隔（秒），-1表示禁用

高级配置选项

证书管理

• --csr：显示创建证书签名请求所需数据
• --ab/--applicationcertbase64：以base64字符串更新应用程序证书
• --af/--applicationcertfile：通过证书文件更新应用程序证书
• --tb/--addtrustedcertbase64：以base64字符串添加受信任证书

特殊运行模式

• --rf/--runforever：使发布者持续运行，无法通过控制台按键停止
• --ic/--iotcentral：以IoT Central兼容格式发送OPC UA数据

最佳实践建议

1. 连接字符串管理：首次启动时指定IoT Hub连接字符串，后续启动可省略以避免设备重新注册

2. 性能优化：

   • 根据网络状况调整--iothubmessagesize和--iothubsendinterval
   • 监控队列使用情况调整--monitoreditemqueuecapacity

3. 安全建议：

   • 生产环境慎用--autoaccept
   • 定期更新证书存储

4. 诊断配置：

   • 开发阶段可使用--loglevel debug获取详细日志
   • 生产环境建议使用--loglevel info或更高

通过合理配置这些参数，可以优化OPC Publisher的性能、安全性和可靠性，满足不同工业场景的需求。