ProvisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Devices.Provisioning.Service

Assembly:

Microsoft.Azure.Devices.Provisioning.Service.dll

Paquet:

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

Surcharges

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)	Créez ou mettez à jour un enregistrement d’inscription d’appareil individuel.
CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)	Crée ou met à jour une inscription individuelle.

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)

Créez ou mettez à jour un enregistrement d’inscription d’appareil individuel.

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)

Paramètres

individualEnrollment

IndividualEnrollment

objet IndividualEnrollment qui décrit l’individualEnrollment qui sera créé de mis à jour. Ne peut pas être null.

Retours

Task<IndividualEnrollment>

Objet IndividualEnrollment avec le résultat de la création ou de la mise à jour demandée.

Exceptions

ArgumentException

si le paramètre fourni n’est pas correct.

ProvisioningServiceClientTransportException

si le KIT de développement logiciel (SDK) n’a pas pu envoyer la demande au service Device Provisioning.

ProvisioningServiceClientException

si le service Device Provisioning n’a pas pu créer ou mettre à jour l’inscription individuelle.

Exemples

Le code suivant crée un nouvel individualEnrollment qui provisionnera l’inscriptionid-1 à l’aide de l’attestation TPM. Informations d’inscription individuelles. 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)) { // *** ******* Créer l’inscription individuelle *** Console.WriteLine(« \nCreate a new individualEnrollment... »); Attestation attestation = nouvelle TpmAttestation(TPM_ENDORSEMENT_KEY) ; IndividualEnrollment individualEnrollment = new IndividualEnrollment( REGISTRATION_ID, attestation); individualEnrollment.ProvisioningStatus = ProvisioningStatus.Disabled; IndividualEnrollment individualEnrollmentResult = await provisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync(individualEnrollment). ConfigureAwait(false) ; Console.WriteLine(« \nIndividualEnrollment créé avec succès... »); } }

Le code suivant met à jour l’approvisionnementStatus de l’inscription individuelle précédente de désactivé à activé. Informations d’inscription individuelles. 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)) { // ****** Obtenir le contenu de l’inscription individuelle précédente *** Console.WriteLine(« \nObtenir le contenu de l’individuEnrollment précédent... »); Attestation attestation = nouvelle 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 mis à jour avec succès... »); } }

Remarques

Cette API crée un individualEnrollment ou met à jour un existant. Toutes les inscriptions dans le service Device Provisioning contiennent un identificateur unique appelé registrationId. Si cette API est appelée pour un individualEnrollment avec un registrationId qui existe déjà, elle remplace les informations individualEnrollment existantes par la nouvelle. En revanche, si le registrationId ne se quitte pas, cette API crée un nouvel élément individualEnrollment.

Si l’registrationId existe déjà, cette méthode met à jour les inscriptions existantes. Notez que la mise à jour de l’inscription individuelle ne modifie pas le status de l’appareil déjà inscrit à l’aide de l’ancien individualEnrollment.

Pour utiliser l’API Device Provisioning Service, vous devez inclure le package suivant dans votre application. // Include the following using to use the Device Provisioning Service APIs. using Microsoft.Azure.Devices.Provisioning.Service;

CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)

Crée ou met à jour une inscription individuelle.

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)

Paramètres

individualEnrollment

IndividualEnrollment

Objet d’inscription individuel.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<IndividualEnrollment>