ProvisioningServiceClient.CreateOrUpdateIndividualEnrollmentAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment) |
個々のデバイス登録レコードを作成または更新します。 |
| CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken) |
個々の登録を作成または更新します。 |
CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment)
個々のデバイス登録レコードを作成または更新します。
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)パラメーター
- individualEnrollment
- IndividualEnrollment
更新された IndividualEnrollment の作成される individualEnrollment を記述する オブジェクト。 null にすることはできません。
戻り値
IndividualEnrollment作成または更新が要求された結果を含む オブジェクト。
例外
指定されたパラメーターが正しくない場合は 。
SDK が Device Provisioning Service に要求を送信できなかった場合は 。
Device Provisioning Service が individualEnrollment を作成または更新できなかった場合。
例
次のコードでは、TPM 構成証明を使用して registrationid-1 をプロビジョニングする新しい individualEnrollment が作成されます。
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)) { // ******** **** ** Console.WriteLine("\n新しい individualEnrollment..");構成証明構成証明 = 新しい 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 created with success..."); } }
次のコードでは、前の individualEnrollment の provisioningStatus が 無効 から 有効に更新されます。
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)) { // ********* **** 前の individualEnrollment **** Console.WriteLine("\n前の individualEnrollment....") のコンテンツを取得します。構成証明構成証明 = 新しい 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 updated with success..."); } }
注釈
この API は、新しい individualEnrollment を作成するか、存在するものを更新します。 Device Provisioning Service のすべての登録には、registrationId という一意の識別子が含まれています。 この API が既に存在する registrationId を持つ individualEnrollment に対して呼び出されると、存在する individualEnrollment 情報が新しい情報に置き換えられます。 一方、registrationId が終了しない場合、この API は新しい individualEnrollment を作成します。
registrationId が既に存在する場合、このメソッドは存在する登録を更新します。 individualEnrollment を更新すると、古い individualEnrollment を使用して既に登録されているデバイスの状態は変更されないことに注意してください。
Device Provisioning Service API を使用するには、アプリケーションに次のパッケージを含める必要があります。 // Include the following using to use the Device Provisioning Service APIs. using Microsoft.Azure.Devices.Provisioning.Service;
適用対象
CreateOrUpdateIndividualEnrollmentAsync(IndividualEnrollment, CancellationToken)
個々の登録を作成または更新します。
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)パラメーター
- individualEnrollment
- IndividualEnrollment
個々の登録オブジェクト。
- cancellationToken
- CancellationToken
キャンセル トークン。
戻り値
適用対象
Azure SDK for .NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示