ProvisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync Método

Definição

Namespace:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Pacote:

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

Sobrecargas

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)	Criar ou atualizar um registro de dispositivo individual.
CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)	Cria ou atualiza um registro individual.

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)

Criar ou atualizar um registro de dispositivo individual.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment> CreateOrUpdateIndividualEnrollmentAsync (Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment individualEnrollment);

member this.CreateOrUpdateIndividualEnrollmentAsync : Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment>

Public Function CreateOrUpdateIndividualEnrollmentAsync (individualEnrollment As IndividualEnrollment) As Task(Of IndividualEnrollment)

Parâmetros

individualEnrollment

IndividualEnrollment

o IndividualEnrollment objeto que descreve o individualEnrollment que será criado de atualizado. Não pode ser null.

Retornos

Task<IndividualEnrollment>

Um IndividualEnrollment objeto com o resultado da criação ou atualização solicitada.

Exceções

ArgumentException

se o parâmetro fornecido não estiver correto.

ProvisioningServiceClientTransportException

se o SDK não tiver enviado a solicitação para o Serviço de Provisionamento de Dispositivos.

ProvisioningServiceClientException

se o Serviço de Provisionamento de Dispositivos não foi capaz de criar ou atualizar o individualEnrollment.

Exemplos

O código a seguir criará um novo individualEnrollment que provisionará o registrationid-1 usando o atestado do TPM. Informações de IndividualEnrollment. private const string PROVISIONING_CONNECTION_STRING = "HostName=ContosoProvisioning.azure-devices-provisioning.net;" + "SharedAccessKeyName=contosoprovisioningserviceowner;" + "SharedAccessKey=dGVzdFN0cmluZzE="; private const string TPM_ENDORSEMENT_KEY = "tpm-endorsement-key"; private const string REGISTRATION_ID = "registrationid-1";

static void Main(string[] args) { RunSample(). GetAwaiter(). GetResult(); }

public static async Task RunSample() { using(ProvisioningServiceClient provisioningServiceClient = ProvisioningServiceClient.CreateFromConnectionString(PROVISIONING_CONNECTION_STRING)) { // **** **** Crie o individualEnrollment ****Console.WriteLine("\nCriar um novo Registro individual..."); Atestado de atestado = novo TpmAttestation(TPM_ENDORSEMENT_KEY); IndividualEnrollment individualEnrollment = new IndividualEnrollment( REGISTRATION_ID, atestado); individualEnrollment.ProvisioningStatus = ProvisioningStatus.Disabled; IndividualEnrollment individualEnrollmentResult = await provisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync(individualEnrollment). ConfigureAwait(false); Console.WriteLine("\nIndividualEnrollment criado com êxito..."); } }

O código a seguir atualizará o provisioningStatus do individualEnrollment anterior de desabilitado para habilitado. Informações de IndividualEnrollment. private const string PROVISIONING_CONNECTION_STRING = "HostName=ContosoProvisioning.azure-devices-provisioning.net;" + "SharedAccessKeyName=contosoprovisioningserviceowner;" + "SharedAccessKey=dGVzdFN0cmluZzE="; private const string REGISTRATION_ID = "registrationid-1";

static void Main(string[] args) { RunSample(). GetAwaiter(). GetResult(); }

public static async Task RunSample() { using(ProvisioningServiceClient provisioningServiceClient = ProvisioningServiceClient.CreateFromConnectionString(PROVISIONING_CONNECTION_STRING)) { // **** ****** Obtenha o conteúdo do individualEnrollment anterior ****Console.WriteLine("\nObter o conteúdo do individualEnrollment anterior..."); Atestado de atestado = novo TpmAttestation(TPM_ENDORSEMENT_KEY); IndividualEnrollment individualEnrollment = await deviceProvisioningServiceClient.GetIndividualEnrollmentAsync(REGISTRATION_ID). ConfigureAwait(false); individualEnrollment.ProvisioningStatus = ProvisioningStatus.Enabled; IndividualEnrollment individualEnrollmentResult = await provisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync(individualEnrollment). ConfigureAwait(false); Console.WriteLine("\nIndividualEnrollment atualizado com êxito..."); } }

Comentários

Essa API cria um novo individualEnrollment ou atualiza um existente. Todos os registros no Serviço de Provisionamento de Dispositivos contêm um identificador exclusivo chamado registrationId. Se essa API for chamada para um individualEnrollment com uma registrationId que já existe, ela substituirá as informações individualEnrollment existentes pela nova. Por outro lado, se o registrationId não for encerrado, essa API criará um novo individualEnrollment.

Se a registrationId já existir, esse método atualizará os registros existentes. Observe que atualizar individualEnrollment não alterará o status do dispositivo que já foi registrado usando o individualEnrollment antigo.

Para usar a API do Serviço de Provisionamento de Dispositivos, você deve incluir o pacote a seguir em seu aplicativo. // Include the following using to use the Device Provisioning Service APIs. using Microsoft.Azure.Devices.Provisioning.Service;

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)

Cria ou atualiza um registro individual.

public System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment> CreateOrUpdateIndividualEnrollmentAsync (Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment individualEnrollment, System.Threading.CancellationToken cancellationToken);

member this.CreateOrUpdateIndividualEnrollmentAsync : Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Devices.Provisioning.Service.IndividualEnrollment>

Public Function CreateOrUpdateIndividualEnrollmentAsync (individualEnrollment As IndividualEnrollment, cancellationToken As CancellationToken) As Task(Of IndividualEnrollment)

Parâmetros

individualEnrollment

IndividualEnrollment

O objeto de registro individual.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<IndividualEnrollment>