sysmail_update_account_sp (Transact-SQL)

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

Conventions de la syntaxe de 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. L'argument 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 pour l'envoi de 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 une valeur par défaut NULL.

• [ @mailserver_name = ] 'server_name'
  Nouveau nom de serveur de messagerie SMTP à utiliser pour ce compte. L'ordinateur qui exécute Microsoft SQL Server doit pouvoir résoudre server_name en adresse IP. server_name est de type sysname, sans 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. Avec Microsoft SQL Server 2005, seule la valeur « SMTP » est prise en charge.

• [ @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 à utiliser pour se connecter au serveur de messagerie. username est de type sysname et n'a pas de valeur par défaut.

• [ @password = ] 'password'
  Nouveau mot de passe à utiliser pour se connecter 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 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 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 = ] 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.

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

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

Valeurs des codes renvoyés

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

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 et SQL Mail (Transact-SQL)

Autres ressources

Messagerie de base de données
Comptes de messagerie de base de données
Sélectionner une tâche de configuration (messagerie de base de données)

Aide et Informations

Assistance sur SQL Server 2005