CERTPROPERTY (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt den Wert einer angegebenen Zertifikateigenschaft zurück.

Transact-SQL-Syntaxkonventionen

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )  
  
<PropertyName> ::=  
   Expiry_Date | Start_Date | Issuer_Name   
   | Cert_Serial_Number | Subject | SID | String_SID

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

Cert_ID
Der ID-Wert des Zertifikats, der den Datentyp „int“ aufweist.

Expiry_Date
Das Ablaufdatum des Zertifikats.

Start_Date
Das Datum, an dem das Zertifikat gültig wird.

Issuer_Name
Der Name des Zertifikatausstellers.

Cert_Serial_Number
Die Seriennummer des Zertifikats.

Subject
Der Zertifikatantragsteller.

SID
Die SID des Zertifikats. Dies ist auch die SID eines diesem Zertifikat zugeordneten Anmeldenamens oder Benutzers.

String_SID
Die SID des Zertifikats als Zeichenfolge. Dies ist auch die SID eines diesem Zertifikat zugeordneten Anmeldenamens oder Benutzers.

Rückgabetypen

Die Angabe der Eigenschaft muss in einfache Anführungszeichen eingeschlossen werden.

Der Rückgabetyp hängt von der im Funktionsaufruf angegebenen Eigenschaft ab. Der Rückgabetyp sql_variant umschließt alle Rückgabewerte.

  • Expiry_Date und Start_Date geben datetimezurück.
  • Cert_Serial_Number, Issuer_Name, String_SID und Subject geben nvarchar zurück.
  • SID gibt varbinaryzurück.

Hinweise

Weitere Informationen zu Zertifikaten finden Sie in der Katalogsicht sys.certificates.

Berechtigungen

Erfordert geeignete Berechtigungen für das Zertifikat, und dem Aufrufer darf die VIEW-Berechtigung für das Zertifikat nicht verweigert worden sein. Weitere Informationen zu Zertifikatberechtigungen finden Sie unter CREATE CERTIFICATE (Transact-SQL) und GRANT CERTIFICATE PERMISSIONS (Transact-SQL).

Beispiele

Im folgenden Beispiel wird der Zertifikatsantragsteller zurückgegeben.

-- First create a certificate.  
CREATE CERTIFICATE Marketing19 WITH   
    START_DATE = '04/04/2004' ,  
    EXPIRY_DATE = '07/07/2040' ,  
    SUBJECT = 'Marketing Print Division';  
GO  
  
-- Now use CertProperty to examine certificate  
-- Marketing19's properties.  
DECLARE @CertSubject sql_variant;  
set @CertSubject = CertProperty( Cert_ID('Marketing19'), 'Subject');  
PRINT CONVERT(nvarchar, @CertSubject);  
GO

Siehe auch

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Verschlüsselungshierarchiesys.certificates (Transact-SQL)Sicherheitskatalogsichten (Transact-SQL)