Partager via


sysmail_help_account_sp (Transact-SQL)

Répertorie les informations (à l'exception des mots de passe) relatifs aux comptes de messagerie de base de données.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]

Arguments

  • [ @account_id = ] account_id
    ID de compte pour lequel les informations seront répertoriées. account_id est de type int, et la valeur par défaut est NULL.

  • [ @account_name = ] 'account_name'
    Nom de compte pour lequel les informations seront répertoriées. account_name est de type sysname et sa valeur par défaut est NULL.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Jeux de résultats

Retourne un jeu de résultats contenant les colonnes répertoriées ci-après.

Nom de colonne

Type de données

Description

account_id

int

Identificateur du compte.

name

sysname

Nom du compte.

description

nvarchar(256)

Description du compte.

email_address

nvarchar(128)

Adresse électronique à partir de laquelle les messages sont envoyés.

display_name

nvarchar(128)

Nom complet du compte.

replyto_address

nvarchar(128)

Adresse à laquelle les réponses aux messages de ce compte sont envoyées.

servertype

sysname

Type de serveur de messagerie pour le compte.

servername

sysname

Nom du serveur de messagerie pour le compte.

port

int

Numéro de port utilisé par le serveur de messagerie.

username

nvarchar(128)

Nom d'utilisateur à utiliser pour se connecter au serveur de messagerie, si ce serveur utilise l'authentification. Si username est NULL, la messagerie de base de données n'utilise pas l'authentification pour ce compte.

use_default_credentials

bit

Spécifie si le courrier électronique doit être envoyé au serveur SMTP en utilisant les informations d'identification du moteur de base de données SQL Server. L'argument use_default_credentials est de type bit, et n'a pas de valeur par défaut. Lorsque la valeur de ce paramètre est définie sur 1, la messagerie de base de données utilise les informations d'identification du service du moteur de base de données SQL Server. Lorsqu'elle est définie sur 0, la messagerie de base de données utilise @username et @password pour l'opération d'authentification sur le serveur SMTP. Si la valeur de ces deux arguments est NULL, la messagerie de base de données utilise l'authentification anonyme. Contactez votre administrateur SMTP avant de définir ce paramètre.

enable_ssl

bit

Spécifie si la messagerie de base de données chiffre les communications à l'aide de la technologie SSL (Secure Sockets Layer). Utilisez cette option si SSL est obligatoire sur votre serveur SMTP. enable_ssl est de type bit et n'a pas de valeur par défaut. 1 indique que la messagerie de base de données chiffre les communications au moyen de SSL tandis que la valeur 0 indique qu'elle envoie le courrier sans le chiffrement SSL.

Notes

Si account_id ou account_name n'est pas spécifié, sysmail_help_account répertorie les informations relatives à tous les comptes de messagerie de base de données dans l'instance Microsoft SQL Server.

La procédure stockée sysmail_help_account_sp se trouve dans la base de données msdb et est détenue par le schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données active n'est pas msdb.

Autorisations

Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemple

A. Affichage d'informations relatives à tous les comptes

L'exemple suivant illustre comment répertorier les informations relatives à tous les comptes de l'instance.

EXECUTE msdb.dbo.sysmail_help_account_sp ;

Voici un exemple de jeu de résultats, modifié pour la longueur de ligne :

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      
149         Audit Account                Account for audit e-mail.               audit@Adventure-Works.com Automated Mailer (Audit)         NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      

B. Affichage d’informations sur un compte spécifique

L'exemple suivant illustre comment répertorier les informations relatives au compte nommé AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks Administrator' ;

Voici un exemple de jeu de résultats, modifié pour la longueur de ligne :

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0