• Artículo

sysmail_update_profile_sp (Transact-SQL)

Cambia la descripción o el nombre de un perfil del Correo electrónico de base de datos.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]

Argumentos

  • [ @profile_id = ] profile_id
    Id. de perfil que se va a actualizar. profile_id es de tipo int y su valor predeterminado es NULL. Se debe especificar profile_id o profile_name. Si se especifican los dos, el procedimiento cambia el nombre del perfil.

  • [ @profile_name = ] 'profile_name'
    Nombre del perfil que se va a actualizar o nombre nuevo del perfil. profile_name es de tipo sysname y su valor predeterminado es NULL. Se debe especificar profile_id o profile_name. Si se especifican los dos, el procedimiento cambia el nombre del perfil.

  • [ @description = ] 'description'
    Nueva descripción del perfil. description es de tipo nvarchar(256) y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Si se especifican los dos (el Id. de perfil y el nombre de perfil), el procedimiento cambia el nombre del perfil por el nombre proporcionado y actualiza su descripción. Si sólo se proporciona uno de estos argumentos, el procedimiento actualiza la descripción del perfil.

El procedimiento almacenado sysmail_update_profile_sp se encuentra en la base de datos msdb y pertenece al esquema dbo. El procedimiento se debe ejecutar con un nombre de tres partes si la base de datos actual no es msdb.

Permisos

Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros del rol fijo de servidor sysadmin.

Ejemplos

A. Cambiar la descripción de un perfil

En el siguiente ejemplo se cambia la descripción del perfil denominado AdventureWorks2008R2 Administrator de la base de datos msdb.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks2008R2 Administrator'
    ,@description = 'Administrative mail profile.';

B. Cambiar el nombre y la descripción de un perfil

En este ejemplo se cambia el nombre y la descripción del perfil con el Id. de perfil 750.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750
    ,@profile_name = 'Operator'
    ,@description = 'Profile to send alert e-mail to operators.';