sysmail_help_account_sp (Transact-SQL)
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) or 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 c’est NULLle cas, 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