CERTPROPERTY (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

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   

Arguments

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.

Remarks

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

Permissions

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).

Examples

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

ZERTIFIKAT ERSTELLEN (Transact-SQL)
ALTER-ZERTIFIKAT (Transact-SQL)
CERT_ID (Transact-SQL)Verschlüsselungshierarchiesys.certificates (Transact-SQL)Sicherheitskatalogsichten (Transact-SQL)