sysmail_update_account_sp (Transact-SQL)
Modifie les informations dans un compte de messagerie de base de données existant.
.gif "Icône Lien de rubrique")
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 ,
[ @no_credential_change = ] changes to username and password ,
[ @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 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. Pour SQL Server 2005 et versions ultérieures, 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 servant lors de la connexion au serveur de messagerie. User name est de type sysname, sans 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. 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 @username et de @password est NULL, la messagerie de base de données utilise l'authentification anonyme. Contactez votre administrateur SMTP avant de définir ce paramètre.[ @no_credential_change = ] modifications au nom d'utilisateur et au mot de passe
Spécifie si les informations d'identification existantes (nom d'utilisateur et mot de passe) doivent être modifiées. Lorsque ce paramètre a la valeur 1, cela signifie que les informations d'identification ne sont pas modifiées. Dans ce cas, @username et @password ne sont pas requis. Lorsque ce paramètre a la valeur 0, cela signifie que les informations d'identification sont modifiées. Dans ce cas, @username et @password doivent être fournis. Ce paramètre est de type bit avec la valeur par défaut 0.[ @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.
Le paramètre @no_credential_change peut être utilisé pour apporter des modifications portant sur des informations autres que le nom d'utilisateur et le mot de passe pour un compte qui utilise l'authentification de base pour envoyer des messages. Par exemple, vous pouvez activer SSL sans entrer le nom d'utilisateur et le mot de passe en spécifiant @no_credential_change = 1.
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;
C. Utilisation de @no\_credential\_change pour modifier uniquement SSL pour un compte
L'exemple suivant modifie les paramètres SSL pour l'ID de compte 125. Toutes les autres informations de compte demeurent inchangées.
EXECUTE msdb.dbo.sysmail_update_account_sp
,@account_id = 125
,@enable_ssl = 1
,@no_credential_change = 1;
Si @no\_credential\_change=1 n'est pas spécifié, la valeur NULL est attribuée à @username et @password, à moins que des valeurs ne soient fournies.
Historique des modifications
Mise à jour du contenu |
|---|
Ajout d'informations sur le nouveau paramètre @no_credential_change aux sections Syntaxe, Arguments et Remarques. |
Ajout d'un exemple de modification des paramètres SSL à l'aide du nouveau paramètre @no_credential_change. |