Compartir a través de


sysmail_update_profile_sp (Transact-SQL)

Se aplica a: SQL Server

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

Convenciones 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

Identificador de perfil que se va a actualizar. @profile_id es int, con un valor predeterminado de NULL. Se debe especificar al menos uno de @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 sysname, con un valor predeterminado de NULL. Se debe especificar al menos uno de @profile_id o @profile_name . Si se especifican los dos, el procedimiento cambia el nombre del perfil.

[ @description = ] 'description'

La nueva descripción del perfil. @description es nvarchar(256), con un valor predeterminado de NULL.

Valores de código de retorno

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

Comentarios

Cuando se especifican tanto el identificador de perfil como el nombre del perfil, el procedimiento cambia el nombre del perfil al nombre proporcionado y actualiza la descripción del perfil. Si solo se proporciona uno de estos argumentos, el procedimiento actualiza la descripción del perfil.

El procedimiento sysmail_update_profile_sp almacenado está en la msdb base de datos y es propiedad del esquema dbo . 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 descripción de un perfil

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

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Administrative mail profile.';

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

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

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