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

使用 Azure IoT Central 解决方案中的属性

本操作指南介绍了如何使用 Azure IoT Central 应用程序的设备模板中定义的设备属性。

属性表示时间点值。例如，设备可使用属性来报告它尝试达到的目标温度。默认情况下，设备属性在 IoT Central 中是只读的。使用可写属性，你可以在设备与 Azure IoT Central 应用程序之间同步状态。

你还可以在 Azure IoT Central 应用程序中定义云属性。云属性值永远不会与设备进行交换，并且不在本文的讨论范围内。

若要了解有关 IoT 即插即用属性约定的详细信息，请参阅 IoT 即插即用约定。

若要详细了解设备与 IoT Central 交换的属性数据，请参阅遥测、属性和命令有效负载。

若要了解如何使用 IoT Central REST API 管理属性，请参阅如何使用 IoT Central REST API 控制设备。

若要了解如何在不使用设备 SDK 的情况下在设备中实现属性，请参阅使用 MQTT 协议与 IoT 中心通信。

定义属性

属性是表示设备状态的数据字段。使用属性来表示设备的持久状态，例如设备的开/关状态。属性还可以表示基本设备属性，例如设备的软件版本。请将属性声明为只读属性或可写属性。

以下屏幕截图显示了 Azure IoT Central 应用程序中的属性定义。

下表显示了属性功能的配置设置。

字段	说明
Display name	“仪表板磁贴”和“设备”窗体上使用的属性值的显示名称。
名称	属性的名称。 Azure IoT Central 会根据显示名称生成此字段的值，但你可以视需要选择自己的值。此字段必须为字母数字。设备代码使用此“名称”值。
功能类型	属性。
语义类型	属性的语义类型，如温度、状态或事件。选择的语义类型将决定以下哪些字段可用。
架构	属性数据类型，如 double、string 或 vector。语义类型决定可用的选项。架构不可用于事件和状态语义类型。
可写	如果属性不是可写的，则设备可向 Azure IoT Central 报告属性值。如果属性是可写的，则设备可向 Azure IoT Central 报告属性值。然后，Azure IoT Central 可以将属性更新发送到设备。
严重性	仅适用于事件语义类型。严重性为“错误”、“信息”或“警告”。
状态值	仅适用于状态语义类型。定义可能的状态值，其中每个状态值都具有显示名称、名称、枚举类型和值。
计价单位	属性值的单位，例如 mph、% 或 °C。
显示单位	“仪表板磁贴”和“设备”窗体上使用的显示单位。
评论	有关属性功能的任何注释。
说明	属性功能的说明。