Partage via


sysmail_update_account_sp (Transact-SQL)

S'applique à : SQL Server

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

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
    , [ @timeout = ] 'timeout'
    , [ @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 int, avec la valeur par défaut NULL. Au moins un des @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 sysname, avec la valeur par défaut NULL. Au moins un des @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 nvarchar(128), avec la valeur par défaut NULL.

[ @display_name = ] 'display_name'

Nouveau nom complet à utiliser sur des messages électroniques à partir de ce compte. @display_name est nvarchar(128), sans 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 nvarchar(128), sans valeur par défaut.

[ @description = ] 'description'

Nouvelle description du compte. @description est nvarchar(256), avec la 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 être en mesure de résoudre le @mailserver_name en adresse IP. @mailserver_name est sysname, sans valeur par défaut.

[ @mailserver_type = ] 'server_type'

Nouveau type du serveur de messagerie. @mailserver_type est sysname, sans valeur par défaut. Seule une valeur est SMTP prise en charge.

[ @port = ] port_number

Nouveau numéro de port du serveur de messagerie. @port est int, sans valeur par défaut.

[ @timeout = ] 'timeout'

Paramètre de délai d’expiration d’un SmtpClient.Send seul e-mail. @timeout est int en secondes, sans valeur par défaut.

[ @username = ] 'username'

Nouveau nom d'utilisateur servant lors de la connexion au serveur de messagerie. @username est sysname, sans valeur par défaut.

[ @password = ] 'password'

Nouveau mot de passe servant lors de la connexion au serveur de messagerie. @password est sysname, sans valeur par défaut.

[ @use_default_credentials = ] use_default_credentials

Spécifie s’il faut envoyer le courrier au serveur SMTP à l’aide des informations d’identification du service sql Server Moteur de base de données. @use_default_credentials est bit, sans valeur par défaut. Lorsque ce paramètre est 1, La messagerie de base de données utilise les informations d’identification du Moteur de base de données. Lorsque ce paramètre est 0, 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, il 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 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. @enable_ssl est bit, sans valeur par défaut.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

Lorsque le nom du compte et l’ID de compte sont spécifiés, la procédure stockée modifie le nom du compte en plus de mettre à jour les informations du compte. La modification du nom du compte est utile pour corriger les erreurs dans le nom du compte.

La procédure sysmail_update_account_sp stockée se trouve dans la msdb base de données et appartient au dbo schéma. 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. Modifier les informations d’un compte

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

EXEC 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,
    @timeout = 60,
    @username = NULL,
    @password = NULL,
    @use_default_credentials = 0,
    @enable_ssl = 0;

B. Modifier le nom d’un compte et les informations d’un compte

L’exemple suivant modifie le nom et met à jour les informations de compte pour l’ID 125de compte. Le nouveau nom du compte est Backup Mail Server.

EXEC 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,
    @timeout = 60,
    @username = NULL,
    @password = NULL,
    @use_default_credentials = 0,
    @enable_ssl = 0;