CERTPROPERTY (Transact-SQL)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceDatabase SQL di Microsoft Fabric

Mengembalikan nilai properti sertifikat yang ditentukan.

Konvensi sintaks transact-SQL

Syntax

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

Arguments

Cert_ID
Nilai ID sertifikat, dari int tipe data.

Expiry_Date
Tanggal kedaluwarsa sertifikat.

Start_Date
Tanggal ketika sertifikat menjadi valid.

Issuer_Name
Nama penerbit sertifikat.

Cert_Serial_Number
Nomor seri sertifikat.

Subject
Subjek sertifikat.

SID
Sertifikat SID. Ini juga merupakan SID dari setiap login atau pengguna yang dipetakan ke sertifikat ini.

String_SID
SID sertifikat sebagai string karakter. Ini juga merupakan SID dari setiap login atau pengguna yang dipetakan ke sertifikat.

Tipe pengembalian

Tanda kutip tunggal harus mengapit spesifikasi properti.

Jenis pengembalian tergantung pada properti yang ditentukan dalam panggilan fungsi. Jenis pengembalian sql_variant membungkus semua nilai yang dikembalikan.

• Expiry_Date dan Start_Date mengembalikan tanggalwaktu.
• Cert_Serial_Number, Issuer_Name, String_SID, dan Subjek semuanya mengembalikan nvarchar.
• SID mengembalikan varbinary.

Remarks

Lihat informasi sertifikat dalam tampilan katalog sys.certificates .

Permissions

Memerlukan izin yang sesuai pada sertifikat, dan mengharuskan pemanggil belum ditolak izin VIEW pada sertifikat. Lihat MEMBUAT SERTIFIKAT (Transact-SQL) dan MEMBERIKAN IZIN SERTIFIKAT (Transact-SQL) untuk informasi selengkapnya tentang izin sertifikat.

Examples

Contoh berikut mengembalikan subjek sertifikat.

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

Lihat juga

BUAT SERTIFIKAT (Transact-SQL)
UBAH SERTIFIKAT (Transact-SQL)
CERT_ID (Transact-SQL)Hierarki enkripsi sys.certificates(Transact-SQL)Tampilan Katalog Keamanan (Transact-SQL)