CertificateClient.DownloadCertificateAsync Methode

Referenz

Definition

Namespace:: Azure.Security.KeyVault.Certificates

Assembly:: Azure.Security.KeyVault.Certificates.dll

Paket:: Azure.Security.KeyVault.Certificates v4.6.0

Paket:: Azure.Security.KeyVault.Certificates v4.6.0-beta.2

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

DownloadCertificateAsync(String, String, CancellationToken)	Erstellt eine X509Certificate2 aus dem angegebenen Zertifikat.
DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)	Erstellt eine X509Certificate2 aus dem angegebenen Zertifikat.

DownloadCertificateAsync(String, String, CancellationToken)

Quelle:: CertificateClient.cs

Quelle:: CertificateClient.cs

Erstellt eine X509Certificate2 aus dem angegebenen Zertifikat.

public virtual System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>> DownloadCertificateAsync (string certificateName, string version = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificateAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
override this.DownloadCertificateAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>

Public Overridable Function DownloadCertificateAsync (certificateName As String, Optional version As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of X509Certificate2))

Parameter

certificateName: String

Der Name des herunterzuladenden Zertifikats.

version: String

Optionale Version eines Zertifikats zum Herunterladen.

cancellationToken: CancellationToken

Ein CancellationToken , der die Lebensdauer der Anforderung steuert.

Gibt zurück

Task<Response<X509Certificate2>>

Ein X509Certificate2 aus dem angegebenen Zertifikat.

Ausnahmen

InvalidOperationException

Das verwaltete Geheimnis enthielt kein Zertifikat.

ArgumentException

certificateName ist leer.

ArgumentNullException

certificateName ist NULL.

InvalidDataException

Das verwaltete Geheimnis enthielt kein Zertifikat.

NotSupportedException

Wird CertificateContentType nicht unterstützt.

PlatformNotSupportedException

Auf dieser Plattform kann keine X509Certificate2 erstellt werden.

RequestFailedException

Fehler bei der Anforderung. Weitere Informationen finden Sie unter ErrorCode und in der Ausnahmemeldung.

Hinweise

Da Cer nur der öffentliche Schlüssel enthält, versucht diese Methode, das verwaltete Geheimnis herunterzuladen, das das vollständige Zertifikat enthält. Wenn Sie nicht über die Berechtigungen zum Abrufen des Geheimnisses verfügen, RequestFailedException wird mit einer entsprechenden Fehlerantwort ausgelöst. Wenn Sie nur den X509Certificate2 öffentlichen Schlüssel verwenden möchten, instanziieren Sie ihn, und übergeben Sie nur die Cer -Eigenschaft. Für diesen Vorgang sind die Berechtigungen zertifikate/get und secrets/get erforderlich.

Gilt für:

DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)

Quelle:: CertificateClient.cs

Quelle:: CertificateClient.cs

Erstellt eine X509Certificate2 aus dem angegebenen Zertifikat.

public virtual System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>> DownloadCertificateAsync (Azure.Security.KeyVault.Certificates.DownloadCertificateOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificateAsync : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
override this.DownloadCertificateAsync : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>

Public Overridable Function DownloadCertificateAsync (options As DownloadCertificateOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of X509Certificate2))