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

EnrollmentGroup 类

定义

命名空间:

Microsoft.Azure.Devices.Provisioning.Service

程序集:

Microsoft.Azure.Devices.Provisioning.Service.dll

包:

Microsoft.Azure.Devices.Provisioning.Service v1.18.1

表示具有 JSON 序列化程序和反序列化程序的单个设备预配服务注册组。

public class EnrollmentGroup : Microsoft.Azure.Devices.Shared.IETagHolder

type EnrollmentGroup = class
    interface IETagHolder

Public Class EnrollmentGroup
Implements IETagHolder

继承

Object

EnrollmentGroup

实现

IETagHolder

示例

序列化后，EnrollmentGroup 将如以下示例所示：

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]"
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled"
}

以下 JSON 是从预配服务接收的 EnrollmentGroup 响应的示例。

{
   "enrollmentGroupId":"validEnrollmentGroupId",
   "attestation":{
       "type":"x509",
       "signingCertificates":{
           "primary":{
               "certificate":"[valid certificate]",
               "info": {
                   "subjectName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "sha1Thumbprint": "0000000000000000000000000000000000",
                   "sha256Thumbprint": "validEnrollmentGroupId",
                   "issuerName": "CN=ROOT_00000000-0000-0000-0000-000000000000, OU=Azure IoT, O=MSFT, C=US",
                   "notBeforeUtc": "2017-11-14T12:34:18Z",
                   "notAfterUtc": "2017-11-20T12:34:18Z",
                   "serialNumber": "000000000000000000",
                   "version": 3
               }
           }
       }
   },
   "iotHubHostName":"ContosoIoTHub.azure-devices.net",
   "provisioningStatus":"enabled",
   "createdDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "lastUpdatedDateTimeUtc": "2017-09-28T16:29:42.3447817Z",
   "etag": "\"00000000-0000-0000-0000-00000000000\""
}

注解

此对象用于将 EnrollmentGroup 信息发送到预配服务，或从预配服务接收 EnrollmentGroup 信息。

若要在预配服务上创建或更新 EnrollmentGroup，应填充此对象并调用公共 API {@link ProvisioningServiceClient#createOrUpdateEnrollmentGroup (EnrollmentGroup) }。 预配服务所需的最少信息是 {@link #enrollmentGroupId} 和 {@link #attestation}。

若要使用 EnrollmentGroup 预配设备，它必须包含具有 {@link X509Attestation} 机制的 signingCertificate 的 X509 芯片。

此类的内容将以 JSON 格式进行序列化，并作为其余 API 的正文发送到预配服务。

此类的内容可以通过从预配服务接收的 JSON 填充，这是由于 Create、update 或 query EnrollmentGroup 等 EnrollmentGroup 操作的结果。

构造函数

EnrollmentGroup(String, Attestation)

创建 EnrollmentGroup 的新实例。

属性

AllocationPolicy	此资源的分配策略。 重写租户级别分配策略。
Attestation	证明的 Getter 和 setter。
Capabilities	设备的功能。
CreatedDateTimeUtc	创建此资源的 DateTime。
CustomAllocationDefinition	自定义分配定义。
EnrollmentGroupId	注册组 ID。
ETag	注册的 ETag。
InitialTwinState	初始孪生状态。
IotHubHostName	将设备分配到的所需 IoT 中心。
IotHubs	可以将设备 (此资源中) 的 IoT 中心的名称列表。 必须是 IoT 中心的租户级列表的子集
LastUpdatedDateTimeUtc	上次更新此资源的 DateTime。
ProvisioningStatus	预配状态。
RegistrationState	当前注册状态。
ReprovisionPolicy	将设备重新预配到 IoT 中心时的行为。

方法

ToString()

以漂亮的打印格式转换此对象。