ProvisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Devices.Provisioning.Service

Ensamblado:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paquete:

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

Sobrecargas

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)	Cree o actualice un registro de inscripción de dispositivos individual.
CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)	Crea o actualiza una inscripción individual.

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)

Cree o actualice un registro de inscripción de dispositivos 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

el IndividualEnrollment objeto que describe el individualEnrollment que se creará de actualizado. No puede ser null.

Devoluciones

Task<IndividualEnrollment>

Objeto IndividualEnrollment con el resultado de la creación o actualización solicitada.

Excepciones

ArgumentException

si el parámetro proporcionado no es correcto.

ProvisioningServiceClientTransportException

si el SDK no pudo enviar la solicitud al servicio Device Provisioning.

ProvisioningServiceClientException

si el servicio Device Provisioning no pudo crear ni actualizar individualMente la inscripción.

Ejemplos

El código siguiente creará una nueva inscripción individual que aprovisionará registrationid-1 mediante la atestación de TPM. Información de inscripción individual. 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)) { // *************** Create the individualEnrollment *******Console.WriteLine("\nCreate a new IndividualEnrollment..."); Atestación de atestación = new TpmAttestation(TPM_ENDORSEMENT_KEY); IndividualEnrollment individualEnrollment = new IndividualEnrollment( REGISTRATION_ID, atestación); individualEnrollment.ProvisioningStatus = ProvisioningStatus.Disabled; IndividualEnrollment individualEnrollmentResult = await provisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync(individualEnrollment). ConfigureAwait(false); Console.WriteLine("\nIndividualEnrollment creado con éxito..."); } }

El código siguiente actualizará el provisioningStatus del individual anteriorEnrollment de deshabilitado a habilitado. Información de inscripción individual. 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)) { // **************** Get the content of the previous individualEnrollment ***** Console.WriteLine("\nGet the content of the previous individualEnrollment..."); Atestación de atestación = new 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 actualizado con éxito..."); } }

Comentarios

Esta API crea una nueva inscripción individual o actualiza una existente. Todas las inscripciones del servicio Device Provisioning contienen un identificador único denominado registrationId. Si se llama a esta API para una inscripción individual con un registrationId que ya existe, reemplazará la información individual existenteEnrollment por la nueva. Por otro lado, si registrationId no sale, esta API creará una nueva inscripción individual.

Si el registrationId ya existe, este método actualizará las inscripciones existentes. Tenga en cuenta que la actualización de individualEnrollment no cambiará el estado del dispositivo que ya se registró mediante la inscripción individual anterior.

Para usar device Provisioning Service API, debe incluir el paquete siguiente en la aplicación. // Include the following using to use the Device Provisioning Service APIs. using Microsoft.Azure.Devices.Provisioning.Service;

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)

Crea o actualiza una inscripción 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

Objeto de inscripción individual.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<IndividualEnrollment>