sysmail_add_profile_sp (Transact-SQL)

Crea un nuevo perfil de Correo electrónico de base de datos.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] 'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]

Argumentos

[ @profile_name = ] 'profile_name'
Nombre del nuevo perfil. profile_name es de tipo sysname y no tiene valor predeterminado.
[ @description = ] 'description'
Descripción opcional del nuevo perfil. description es de tipo nvarchar(256) y no tiene valor predeterminado.
[ @profile_id = ] new_profile_idOUTPUT
Devuelve el identificador del nuevo perfil. new_profile_id es de tipo int y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Un perfil de Correo electrónico de base de datos contiene cualquier número de cuentas de Correo electrónico de base de datos. Los procedimientos almacenados de Correo electrónico de base de datos pueden hacer referencia a un perfil por el nombre o por el Id. del perfil generado por este procedimiento. Para obtener más información sobre cómo agregar una cuenta a un perfil, vea sysmail_add_profileaccount_sp (Transact-SQL).

El nombre y la descripción del perfil se pueden cambiar con el procedimiento almacenado sysmail_update_profile_sp, mientras que el Id. del perfil permanece constante mientras exista el perfil.

El nombre del perfil debe ser único para el Motor de base de datos de SQL Server de Microsoft o el procedimiento almacenado devuelve un error.

El procedimiento almacenado sysmail_add_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. Crear un nuevo perfil

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.' ;

B. Crear un nuevo perfil y guardar el Id. del perfil en una variable

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator. En el ejemplo se almacena el Id. del perfil en la variable @profileId y se devuelve un conjunto de resultados que contiene el Id. del nuevo perfil.

DECLARE @profileId INT ;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT ;

SELECT @profileId ;