CERTPROPERTY (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體

傳回指定憑證屬性的值。

Transact-SQL 語法慣例

Syntax

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

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

Cert_ID
int 資料類型的憑證識別碼值。

Expiry_Date
憑證到期日期。

Start_Date
憑證生效的日期。

Issuer_Name
憑證簽發者名稱。

Cert_Serial_Number
憑證序號。

主旨
憑證主體。

SID
憑證 SID。 這也是對應至這個憑證之任何登入或使用者的 SID。

String_SID
字元字串格式的憑證 SID。 這也是對應至憑證之任何登入或使用者的 SID。

傳回類型

必須使用單引號括住屬性規格。

傳回類型取決於函式呼叫中所指定的屬性。 傳回類型 sql_variant 會包裝所有傳回值。

  • Expiry_Date 及 Start_Date 會傳回 datetime。
  • Cert_Serial_Number、Issuer_Name、String_SID 和 Subject 全部會傳回 nvarchar。
  • SID 會傳回 varbinary。

備註

請在 sys.certificates 目錄檢視中查看憑證資訊。

權限

需要憑證的適當權限，並且需要呼叫端尚未拒絕憑證的 VIEW 權限。 如需憑證權限的詳細資訊，請參閱 CREATE CERTIFICATE (Transact-SQL) 和 GRANT CERTIFICATE PERMISSIONS (Transact-SQL)。

範例

下列範例會傳回憑證主旨。

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

請參閱

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)加密階層sys.certificates (Transact-SQL)安全性目錄檢視 (Transact-SQL)