你当前正在访问 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 Pug 和 Play 属性约定，请参阅 IoT 即插即用约定。

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

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

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

定义你的属性

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

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

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

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