sysmail_delete_principalprofile_sp (Transact-SQL)

Quita el permiso de un usuario o un rol de base de datos para usar un perfil público o privado de Correo electrónico de base de datos.

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

Sintaxis

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

Argumentos

  • [ @principal_id = ] principal_id
    Es el identificador del usuario o el rol de la base de datos msdb de la asociación que se va a eliminar. principal_id es de tipo int y tiene el valor predeterminado NULL. Para convertir un perfil público en un perfil privado, debe proporcionar el Id. de la entidad de seguridad 0 o el nombre de la entidad de seguridad 'public'. Debe especificarse principal_id o principal_name.

  • [ @principal_name = ] 'principal_name'
    Es el nombre del usuario o el rol de la base de datos msdb de la asociación que se va a eliminar. principal_name es de tipo sysname y tiene el valor predeterminado NULL. Para convertir un perfil público en un perfil privado, debe proporcionar el Id. de la entidad de seguridad 0 o el nombre de la entidad de seguridad 'public'. Debe especificarse principal_id o principal_name.

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

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

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Para convertir un perfil público en un perfil privado, debe proporcionar 'public' para el nombre de la entidad de seguridad o 0 para el Id. de la entidad de seguridad.

Tenga cuidado al quitar permisos para el perfil privado predeterminado de un usuario o el perfil público predeterminado. Si no hay ningún perfil predeterminado disponible, sp_send_dbmail necesita el nombre de un perfil como argumento. Por consiguiente, quitar un perfil predeterminado puede hacer que las llamadas a sp_send_dbmail no se realicen correctamente. Para obtener más información, vea sp_send_dbmail (Transact-SQL).

El procedimiento almacenado sysmail_delete_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

En el siguiente ejemplo se muestra la eliminación de la asociación entre el perfil AdventureWorks2008R2 Administrator y el inicio de sesión ApplicationUser de la base de datos msdb.

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;