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

IndividualEnrollment 类

定义

命名空间:

Microsoft.Azure.Devices.Provisioning.Service

程序集:

Microsoft.Azure.Devices.Provisioning.Service.dll

包:

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

使用 JSON 序列化程序和反序列化程序表示单个设备预配服务注册及其访问器。

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

type IndividualEnrollment = class
    interface IETagHolder

Public Class IndividualEnrollment
Implements IETagHolder

继承

Object

IndividualEnrollment

实现

IETagHolder

示例

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

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
               "endorsementKey":"validEndorsementKey"
        }
    },
    "iotHubHostName":"ContosoIoTHub.azure-devices.net",
    "provisioningStatus":"enabled"
}

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

{
    "registrationId":"validRegistrationId",
    "deviceId":"ContosoDevice-123",
    "attestation":{
        "type":"tpm",
        "tpm":{
            "endorsementKey":"validEndorsementKey"
        }
    },
    "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\""
}

注解

此对象用于向/从预配服务发送和接收单个注册信息。

若要在预配服务上创建或更新注册，应填充此对象并调用公共 API CreateOrUpdateAsync(IndividualEnrollment, CancellationToken)。

预配服务所需的最少信息是 RegistrationId 和证明。

可以通过三种证明机制预配新设备：X509 () X509Attestation 、对称密钥 (请参阅 SymmetricKeyAttestation和 TPM (TpmAttestation) 。 应使用的每个设备的定义，具体取决于设备包含的物理身份验证硬件。

此类的内容将以 JSON 格式序列化，并作为其余 API 的正文发送到预配服务。 或者，此类的内容可以通过从预配服务接收的 JSON 填充，作为创建、更新或查询等单个注册操作的结果。

构造函数

IndividualEnrollment(String, Attestation)

创建 IndividualEnrollment 的新实例。

属性

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

方法

ToString()

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