sysmail_update_account_sp (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Cambia la información de una cuenta existente del Correo electrónico de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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
[ ; ]

Argumentos

[ @account_id = ] account_id

Identificador de la cuenta que se va a actualizar. @account_id es int, con un valor predeterminado de NULL. Se debe especificar al menos uno de @account_id o @account_name . Si se especifican los dos, el procedimiento cambia el nombre de la cuenta.

[ @account_name = ] 'account_name'

Nombre de la cuenta que se va a actualizar. @account_name es sysname, con un valor predeterminado de NULL. Se debe especificar al menos uno de @account_id o @account_name . Si se especifican los dos, el procedimiento cambia el nombre de la cuenta.

[ @email_address = ] 'email_address'

Es la nueva dirección de correo electrónico desde la que se envía el mensaje. Esta dirección debe ser una dirección de correo electrónico de Internet. El nombre de servidor de la dirección es el servidor que Database Mail utiliza para enviar correo de esta cuenta. @email_address es nvarchar(128), con un valor predeterminado de NULL.

[ @display_name = ] 'display_name'

Nuevo nombre para mostrar que se utilizará en los mensajes de correo electrónico de esta cuenta. @display_name es nvarchar(128), sin ningún valor predeterminado.

[ @replyto_address = ] 'replyto_address'

Nueva dirección que se utilizará en el encabezado Responder a de los mensajes de correo electrónico de esta cuenta. @replyto_address es nvarchar(128), sin ningún valor predeterminado.

[ @description = ] 'description'

Nueva descripción de la cuenta. @description es nvarchar(256), con un valor predeterminado de NULL.

[ @mailserver_name = ] 'server_name'

Es el nuevo nombre del servidor de correo SMTP que se debe utilizar para esta cuenta. El equipo que ejecuta SQL Server debe poder resolver el @mailserver_name en una dirección IP. @mailserver_name es sysname, sin ningún valor predeterminado.

[ @mailserver_type = ] 'server_type'

Nuevo tipo del servidor de correo. @mailserver_type es sysname, sin ningún valor predeterminado. Solo se admite un valor de SMTP .

[ @port = ] port_number

Nuevo número de puerto del servidor de correo. @port es int, sin valor predeterminado.

[ @timeout = ] 'timeout'

Parámetro de tiempo de espera de SmtpClient.Send un único mensaje de correo electrónico. @timeout es int en segundos, sin ningún valor predeterminado.

[ @username = ] 'username'

Nuevo nombre de usuario que se utilizará para iniciar sesión en el servidor de correo. @username es sysname, sin ningún valor predeterminado.

[ @password = ] 'password'

Nueva contraseña que se utilizará para iniciar sesión en el servidor de correo. @password es sysname, sin ningún valor predeterminado.

[ @use_default_credentials = ] use_default_credentials

Especifica si se debe enviar el correo al servidor SMTP mediante las credenciales del servicio Motor de base de datos de SQL Server. @use_default_credentials es bit, sin valor predeterminado. Cuando este parámetro es 1, Correo electrónico de base de datos usa las credenciales del Motor de base de datos. Cuando este parámetro es 0, Correo electrónico de base de datos usa el @username y @password para la autenticación en el servidor SMTP. Si @username y @password son NULL, usa la autenticación anónima. Consulte con el administrador de SMTP antes de especificar este parámetro.

[ @enable_ssl = ] enable_ssl

Especifica si Correo electrónico de base de datos cifra la comunicación mediante la seguridad de la capa de transporte (TLS), anteriormente conocida como Capa de sockets seguros (SSL). Use esta opción si se requiere TLS en el servidor SMTP. @enable_ssl es bit, sin valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

Cuando se especifican tanto el nombre de la cuenta como el identificador de cuenta, el procedimiento almacenado cambia el nombre de la cuenta además de actualizar la información de la cuenta. Cambiar el nombre de la cuenta es útil para corregir errores en el nombre de la cuenta.

El procedimiento sysmail_update_account_sp almacenado está en la msdb base de datos y es propiedad del dbo esquema. El procedimiento debe ejecutarse con un nombre de tres partes si la base de datos actual no msdbes .

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

Ejemplos

A Cambiar la información de una cuenta

En el ejemplo siguiente se actualiza la cuenta AdventureWorks Administrator en la msdb base de datos. La información de la cuenta se establece con los valores proporcionados.

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. Cambiar el nombre de una cuenta y la información de una cuenta

En el ejemplo siguiente se cambia el nombre y se actualiza la información de la cuenta para con el identificador 125de cuenta . El nuevo nombre de la cuenta es 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;

Contenido relacionado