sysmail_update_principalprofile_sp (Transact-SQL)

Actualiza la información para una asociación entre una entidad de seguridad y un perfil.

Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual).

Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_update_principalprofile_sp { @principal_id = principal_id | @principal_name = 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    [ @is_default = ] 'is_default'

Argumentos

• [ @principal_id = ] principal_id
  Identificador del usuario o el rol de la base de datos msdb de la asociación que se va a cambiar. principal_id es de tipo int y su valor predeterminado es NULL. Debe especificarse principal_id o principal_name.

• [ @principal_name = ] 'principal_name'
  Nombre del usuario o el rol de la base de datos msdb de la asociación que se va a actualizar. principal_name es de tipo sysname y su valor predeterminado es NULL. Puede especificarse principal_id o principal_name.

• [ @profile_id = ] profile_id
  Identificador del perfil para la asociación que se va a cambiar. profile_id es de tipo int y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.

• [ @profile_name = ] 'profile_name'
  Nombre del perfil para la asociación que se va a cambiar. profile_name es de tipo sysname y su valor predeterminado es NULL. Debe especificarse profile_id o profile_name.

• [ @is_default = ] 'is_default'
  Determina si este perfil es el perfil predeterminado para el usuario de la base de datos. El usuario de la base de datos solo puede tener un perfil predeterminado. is_default es de tipo bit y no tiene valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Ninguno

Comentarios

Este procedimiento almacenado cambia si el perfil especificado es el perfil predeterminado para el usuario de la base de datos. El usuario de la base de datos solo puede tener un perfil privado predeterminado.

Si el nombre de la entidad de seguridad para la asociación es public o el Id. de la entidad de seguridad para la asociación es 0, este procedimiento almacenado cambia el perfil público. Solo puede haber un perfil público predeterminado.

Si @is_default es '1' y la entidad de seguridad está asociada a más de un perfil, el perfil especificado se convierte en el perfil predeterminado para la entidad de seguridad. El perfil predeterminado anterior sigue estando asociado a la entidad de seguridad, pero ya no es el perfil predeterminado.

El procedimiento almacenado sysmail_update_principalprofile_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. Configurar un perfil como perfil público predeterminado para una base de datos

En el siguiente ejemplo se configura el perfil General Use Profile como perfil público predeterminado para los usuarios de la base de datos msdb.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'General Use Profile',
    @is_default = '1';

B. Configurar un perfil como perfil privado predeterminado para un usuario

En el siguiente ejemplo se configura el perfil AdventureWorks Administrator como perfil predeterminado para la entidad de seguridad ApplicationUser en la base de datos msdb. El perfil ya debe estar asociado a la entidad de seguridad. El perfil predeterminado anterior sigue estando asociado a la entidad de seguridad, pero ya no es el perfil predeterminado.

EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator',
    @is_default = '1' ;

Vea también

Referencia

Procedimientos almacenados de Correo electrónico de base de datos (Transact-SQL)

Conceptos

Correo electrónico de base de datos

Objetos de configuración de Correo electrónico de base de datos