CERTPROPERTY (Transact-SQL)

Articolo
10/16/2024

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure

Restituisce il valore di una proprietà del certificato specificata.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

Cert_ID
Valore di ID certificato, tipo di dati int.

Expiry_Date
Data di scadenza del certificato.

Start_Date
Data in cui il certificato diventa valido.

Issuer_Name
Nome dell'autorità di certificazione.

Cert_Serial_Number
Numero di serie del certificato.

Argomento
Soggetto del certificato.

SID
SID del certificato. Corrisponde anche al SID di qualsiasi account di accesso o utente sul quale è stato eseguito il mapping al certificato.

String_SID
SID del certificato nel formato di stringa di caratteri. Corrisponde anche al SID di qualsiasi account di accesso o utente sul quale è stato eseguito il mapping al certificato.

Tipi restituiti

La specifica della proprietà deve essere racchiusa tra virgolette singole.

Il tipo restituito dipende dalla proprietà specificata nella chiamata alla funzione. Il tipo restituito sql_variant esegue il wrapping di tutti i valori restituiti.

Expiry_Date e Start_Date restituiscono datetime.
Cert_Serial_Number, Issuer_Name, String_SID e Subject restituiscono tutti nvarchar.
SID restituisce un valore varbinary.

Osservazioni:

Le informazioni sui certificati sono disponibili nella vista del catalogo sys.certificates.

Autorizzazioni

Richiede le autorizzazioni appropriate per il certificato ed è necessario che al chiamante non sia stata negata l'autorizzazione VIEW per il certificato. Vedere CREATE CERTIFICATE (Transact-SQL) e GRANT (autorizzazioni per certificati) (Transact-SQL) per altre informazioni sulle autorizzazioni per i certificati.

Esempi

Nell'esempio seguente viene restituito l'oggetto del certificato.

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

Vedi anche

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Gerarchia di crittografia sys.certificates (Transact-SQL)Viste del catalogo relative alla sicurezza (Transact-SQL)

Condividi tramite