CERTPROPERTY (Transact-SQL)

2025-07-29

Van toepassing op:SQL Server Azure SQL Database Azure SQL Managed Instance SQL-database in Microsoft Fabric Preview

Retourneert de waarde van een opgegeven certificaateigenschap.

Syntax

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

Arguments

Cert_ID
De certificaat-id-waarde van het gegevenstype int.

Expiry_Date
De vervaldatum van het certificaat.

Start_Date
De datum waarop het certificaat geldig wordt.

Issuer_Name
De naam van de certificaatverlener.

Cert_Serial_Number
Het serienummer van het certificaat.

Subject
Het certificaatonderwerp.

SID
De certificaat-SID. Dit is ook de SID van elke aanmelding of gebruiker die is toegewezen aan dit certificaat.

String_SID
De SID van het certificaat als tekenreeks. Dit is ook de SID van elke aanmelding of gebruiker die is toegewezen aan het certificaat.

Return types

Enkele aanhalingstekens moeten de eigenschapsspecificatie insluiten.

Het retourtype is afhankelijk van de eigenschap die is opgegeven in de functie-aanroep. Het retourtype sql_variant alle retourwaarden terugloopt.

Expiry_Date en Start_Datedatum/tijd retourneren.
Cert_Serial_Number, Issuer_Name, String_SID en Onderwerp retourneren allemaal nvarchar.
SID retourneert varbinary.

Remarks

Zie de certificaatinformatie in de catalogusweergave sys.certificates .

Permissions

Vereist de juiste machtigingen voor het certificaat en vereist dat de aanroeper de VIEW-machtiging voor het certificaat niet heeft geweigerd. Zie CREATE CERTIFICATE (Transact-SQL) en GRANT CERTIFICATE PERMISSIONS (Transact-SQL) voor meer informatie over certificaatmachtigingen.

Examples

In het volgende voorbeeld wordt het certificaatonderwerp geretourneerd.

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

Feedback

Is deze pagina nuttig?