CERTPROPERTY (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Vrátí hodnotu zadané vlastnosti certifikátu.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

Cert_ID
Hodnota ID certifikátu datového typu int.

Expiry_Date
Datum vypršení platnosti certifikátu.

Start_Date
Datum, kdy se certifikát stane platným.

Issuer_Name
Název vystavitele certifikátu.

Cert_Serial_Number
Sériové číslo certifikátu.

Subject
Předmět certifikátu.

SID
Identifikátor SID certifikátu. Toto je také IDENTIFIKÁTOR SID jakéhokoli přihlášení nebo uživatele namapovaného na tento certifikát.

String_SID
Identifikátor SID certifikátu jako řetězec znaků. Toto je také identifikátor SID libovolného přihlášení nebo uživatele namapovaného na certifikát.

Návratové typy

Jednoduché uvozovky musí uzavřít specifikaci vlastnosti.

Návratový typ závisí na vlastnosti zadané ve volání funkce. Návratový typ sql_variant zabalí všechny vrácené hodnoty.

• Expiry_Date a Start_Date vrátit datum a čas.
• Cert_Serial_Number, Issuer_Name, String_SID a Předmět vrátí nvarchar.
• Identifikátor SID vrátí varbinary.

Remarks

Viz informace o certifikátu v zobrazení katalogu sys.certificates .

Permissions

Vyžaduje příslušná oprávnění k certifikátu a vyžaduje, aby volající nebyl odepřen oprávnění VIEW k certifikátu. Další informace o oprávněních k certifikátu najdete v tématu CREATE CERTIFICATE (Transact-SQL) a UDĚLENÍ OPRÁVNĚNÍ K CERTIFIKÁTU (Transact-SQL).

Examples

Následující příklad vrátí předmět certifikátu.

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

Viz také

VYTVOŘIT CERTIFIKÁT (Transact-SQL)
ALTERŮV CERTIFIKÁT (Transact-SQL)
CERT_ID (Transact-SQL)Sys.certificates (Transact-SQL)Zobrazení katalogu zabezpečení (Transact-SQL)