CertificateClient.DownloadCertificate 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

DownloadCertificate(DownloadCertificateOptions, CancellationToken)	Erstellt ein X509Certificate2 aus dem angegebenen Zertifikat.
DownloadCertificate(String, String, CancellationToken)	Erstellt ein X509Certificate2 aus dem angegebenen Zertifikat.

DownloadCertificate(DownloadCertificateOptions, CancellationToken)

Quelle:: CertificateClient.cs

Quelle:: CertificateClient.cs

Erstellt ein X509Certificate2 aus dem angegebenen Zertifikat.

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

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

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

Parameter

options: DownloadCertificateOptions

Optionen zum Herunterladen und Erstellen von .X509Certificate2

cancellationToken: CancellationToken

Ein CancellationToken , der die Anforderungsdauer steuert.

Gibt zurück

Response<X509Certificate2>

Ein X509Certificate2 aus dem angegebenen Zertifikat.

Ausnahmen

ArgumentNullException

options ist NULL.

InvalidDataException

Das verwaltete Geheimnis enthielt kein Zertifikat.

NotSupportedException

Der CertificateContentType wird nicht unterstützt.

PlatformNotSupportedException

Eine kann auf dieser Plattform nicht erstellt X509Certificate2 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 eine entsprechende Fehlerantwort ausgelöst. Wenn Sie nur den X509Certificate2 öffentlichen Schlüssel verwenden möchten, instanziieren Sie ihn nur über die Cer Eigenschaft. Für diesen Vorgang sind die Berechtigungen zertifikate/get und secrets/get erforderlich.

Gilt für:

DownloadCertificate(String, String, CancellationToken)

Quelle:: CertificateClient.cs

Quelle:: CertificateClient.cs

Erstellt ein X509Certificate2 aus dem angegebenen Zertifikat.

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

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

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