sysmail_update_account_sp (Transact-SQL)

Article
03/07/2014

Modifie les informations dans un compte de messagerie de base de données existant.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_update_account_sp [ [ @account_id = ] account_id ] [ , ] [ [ @account_name = ] 'account_name' ] ,
    [ @email_address = ] 'email_address' , 
    [ @display_name = ] 'display_name' , 
    [ @replyto_address = ] 'replyto_address' ,
    [ @description = ] 'description' , 
    [ @mailserver_name = ] 'server_name' , 
    [ @mailserver_type = ] 'server_type' , 
    [ @port = ] port_number , 
    [ @username = ] 'username' ,
    [ @password = ] 'password' ,
    [ @use_default_credentials = ] use_default_credentials ,
    [ @enable_ssl = ] enable_ssl

Arguments

[ @account_id = ] account_id
ID du compte à mettre à jour. account_id est de type int, avec NULL comme valeur par défaut. Au moins un argument, account_id ou account_name, doit être spécifié. Si les deux arguments sont précisés, la procédure modifie le nom du compte.
[ @account_name = ] 'account_name'
Nom du compte à mettre à jour. account_name est de type sysname, avec NULL comme valeur par défaut. Au moins un argument, account_id ou account_name, doit être spécifié. Si les deux arguments sont précisés, la procédure modifie le nom du compte.
[ @email_address = ] 'email_address'
Nouvelle adresse de messagerie d'où le message est envoyé. Cette adresse doit être une adresse de messagerie Internet. Le nom de serveur figurant dans l'adresse identifie le serveur qu'utilise la messagerie de base de données pour envoyer le courrier à partir de ce compte. email_address est de type nvarchar(128), avec NULL comme valeur par défaut.
[ @display_name = ] 'display_name'
Nouveau nom complet à utiliser sur des messages électroniques à partir de ce compte. display_name est de type nvarchar(128) et n'a pas de valeur par défaut.
[ @replyto_address = ] 'replyto_address'
Nouvelle adresse à utiliser dans le champ « Répondre à » des messages électroniques envoyés à partir de ce compte. replyto_address est de type nvarchar(128) et n'a pas de valeur par défaut.
[ @description = ] 'description'
Nouvelle description du compte. description est de type nvarchar(256), avec NULL comme valeur par défaut.
[ @mailserver_name = ] 'server_name'
Nouveau nom de serveur de messagerie SMTP à utiliser pour ce compte. L'ordinateur qui exécute SQL Server doit être en mesure de résoudre server_name en adresse IP. server_name est de type sysname et n'a pas de valeur par défaut.
[ @mailserver_type = ] 'server_type'
Nouveau type du serveur de messagerie. server_type est de type sysname et n'a pas de valeur par défaut. La seule valeur prise en charge est 'SMTP'.
[ @port = ] port_number
Nouveau numéro de port du serveur de messagerie. port_number est de type int et n'a pas de valeur par défaut.
[ @username = ] 'username'
Nouveau nom d'utilisateur servant lors de la connexion au serveur de messagerie. User name est de type sysname et n'a pas de valeur par défaut.
[ @password = ] 'password'
Nouveau mot de passe servant lors de la connexion au serveur de messagerie. password est de type sysname et n'a pas de valeur par défaut.
[ @use_default_credentials = ] use_default_credentials
Spécifie si le courrier électronique doit être envoyé au serveur SMTP en utilisant les informations d'identification du service 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 moteur de base de données Moteur de base de données. 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 = ] enable_ssl
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.

Valeurs des codes renvoyés

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

Notes

Lorsque le nom et l'ID du compte sont tous deux spécifiés, la procédure stockée change le nom du compte en plus de mettre à jour les autres informations du compte. Il peut s'avérer nécessaire de modifier le nom du compte pour corriger des erreurs qui s'y seraient glissées.

La procédure stockée sysmail_update_account_sp se trouve dans la base de données msdb 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

Nécessite l'appartenance au rôle de serveur fixe sysadmin.

Exemple

A.Modification des informations d'un compte

L'exemple suivant met à jour le compte AdventureWorks Administrator dans la base de données msdb. Les informations du compte prennent les valeurs fournies.

EXECUTE msdb.dbo.sysmail_update_account_sp
    ,@account_name = 'AdventureWorks Administrator'
    ,@description = 'Mail account for administrative e-mail.'
    ,@email_address = 'dba@Adventure-Works.com'
    ,@display_name = 'AdventureWorks Automated Mailer'
    ,@replyto_address = NULL
    ,@mailserver_name = 'smtp.Adventure-Works.com'
    ,@mailserver_type = 'SMTP'
    ,@port = 25
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

B.Modification du nom d'un compte et des informations qui s'y rapportent

L'exemple suivant modifie le nom du compte et le met à jour avec l'ID de compte 125. Le nouveau nom du compte est Backup Mail Server.

EXECUTE msdb.dbo.sysmail_update_account_sp
    ,@account_id = 125
    ,@account_name = 'Backup Mail Server'
    ,@description = 'Mail account for administrative e-mail.'
    ,@email_address = 'dba@Adventure-Works.com'
    ,@display_name = 'AdventureWorks Automated Mailer'
    ,@replyto_address = NULL
    ,@mailserver_name = 'smtp-backup.Adventure-Works.com'
    ,@mailserver_type = 'SMTP'
    ,@port = 25,
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

Voir aussi

Référence

Procédures stockées de messagerie de base de données (Transact-SQL)

Concepts

Messagerie de base de données

Créer un compte de messagerie de base de données

Partager via