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.
.gif "Icône Lien de rubrique")
Conventions 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 du compte pour lequel les informations seront répertoriées. account_id est de type int, avec NULL comme valeur par défaut.[ @account_name = ] 'account_name'
Nom du compte pour lequel les informations seront répertoriées. account_name est de type sysname, avec NULL comme valeur par défaut.
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. 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. 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
Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.
Exemple
A. Création de la liste des 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. Création de la liste des 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
Voir aussi
Référence
Procédures stockées de messagerie de base de données (Transact-SQL)