CERTPROPERTY (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de données SQL dans Microsoft Fabric

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

Conventions de la syntaxe Transact-SQL

Syntax

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.

Remarks

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

Permissions

Nécessite une ou plusieurs autorisations appropriées sur le certificat, et exige que l’appelant n’ait pas été refusé VIEW sur le certificat. Voir CREATE CERTIFICATE (Transact-SQL) et GRANTCERTIFICATE PERMISSIONS (Transact-SQL) pour plus d’informations sur les permissions des certificats.

Examples

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 chiffrementsys.certificates (Transact-SQL)Vues de catalogue de sécurité (Transact-SQL)

  • Last updated on