CERTPROPERTY (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne la valeur d'une propriété de certificat spécifiée.

Syntaxe

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

Arguments

Cert_ID
Valeur d’ID de certificat, du type de données int.

Expiry_Date
Date d'expiration du certificat.

Start_Date
Date à laquelle le certificat devient valide.

Issuer_Name
Nom de l’émetteur du certificat.

Cert_Serial_Number
Numéro de série du certificat.

Subject
Objet du certificat

SID
SID du certificat C'est également le SID de n'importe quelle connexion ou utilisateur mappés à ce certificat.

String_SID
SID du certificat, sous forme de chaîne de caractères. C'est également le SID de n'importe quelle connexion ou utilisateur mappés à ce certificat.

Types de retour

La spécification de la propriété doit être placée dans des guillemets simples.

Le type de valeur retournée dépend de la propriété qui est spécifiée dans l’appel de fonction. Le type de retour sql_variant wrappe toutes les valeurs de retour.

Expiry_Date et Start_Date renvoient datetime.
Cert_Serial_Number, Issuer_Name, String_SID, et Subject retournent nvarchar.
SID renvoie varbinary.

Remarques

Ouvrez la vue de catalogue sys.certificates pour consulter les informations relatives aux certificats.

Autorisations

Nécessite des autorisations sur le certificat, et nécessite que l’appelant ne se soit pas vu refuser l’autorisation VIEW pour le certificat. Pour plus d’informations sur les autorisations de certificat, consultez CREATE CERTIFICATE (Transact-SQL) et GRANT CERTIFICATE PERMISSIONS (Transact-SQL).

Exemples

L'exemple suivant retourne l'objet du certificat.

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

Voir aussi

CREATE CERTIFICATE (Transact-SQL)
ALTER CERTIFICATE (Transact-SQL)
CERT_ID (Transact-SQL)Hiérarchie de chiffrement sys.certificates (Transact-SQL)Vues de catalogue de sécurité (Transact-SQL)

Partage via