Share via

sysmail_help_account_sp (Transact-SQL)

  • Article

S’applique à :SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @account_id = ] account_id

ID du compte pour lequel les informations seront répertoriées. @account_id est int, avec la valeur par défaut NULL.

[ @account_name = ] 'account_name'

Nom du compte pour lequel les informations seront répertoriées. @account_name est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Jeu de résultats

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

Nom de la 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 d'affichage 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. Quand username la valeur est NULL, la messagerie de base de données n’utilise pas l’authentification pour ce compte.
use_default_credentials bit Spécifie s’il faut envoyer le courrier au serveur SMTP à l’aide des informations d’identification du Moteur de base de données SQL Server. Lorsque ce paramètre est 1le cas, Database Mail utilise les informations d’identification du service sql Server Moteur de base de données. Lorsque ce paramètre est 0le cas, La messagerie de base de données utilise les @username et les @password pour l’authentification sur le serveur SMTP. Si @username et @password sont NULL, Database Mail utilise l’authentification anonyme. Consultez votre administrateur SMTP avant de spécifier ce paramètre.
enable_ssl bit Spécifie si la messagerie de base de données chiffre la communication à l’aide du protocole TLS (Transport Layer Security), précédemment appelée SSL (Secure Sockets Layer). Utilisez cette option si TLS est requis sur votre serveur SMTP. 1 indique que la messagerie de base de données chiffre la communication à l’aide de TLS. 0 indique que la messagerie de base de données envoie le courrier sans chiffrement TLS.

Notes

Lorsqu’aucun account_id ou account_name n’est fourni, sysmail_help_account répertorie les informations sur tous les comptes de messagerie de base de données dans l’instance Microsoft SQL Server.

La procédure sysmail_help_account_sp stockée se trouve dans la msdb base de données et appartient au schéma dbo . La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n’est pas msdb.

Autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

R. Répertorier les informations de tous les comptes

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

EXEC msdb.dbo.sysmail_help_account_sp;

Voici un exemple d'ensemble 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. Répertorier les informations d’un compte spécifique

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

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

Voici un exemple d'ensemble 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

Contenu connexe