sysmail_delete_profileaccount_sp (Transact-SQL)

Se aplica a:SQL Server

Quita una cuenta de un perfil del Correo electrónico de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
[ ; ]

Argumentos

[ @profile_id = ] profile_id

El identificador del perfil que se va a eliminar. @profile_id es int, con un valor predeterminado de NULL. Puede especificarse el @profile_id o el @profile_name .

[ @profile_name = ] 'profile_name'

Nombre del perfil que se va a eliminar. @profile_name es sysname, con un valor predeterminado de NULL. Puede especificarse el @profile_id o el @profile_name .

[ @account_id = ] account_id

Identificador de la cuenta que se va a eliminar. @account_id es int, con un valor predeterminado de NULL. Puede especificarse el @account_id o el @account_name .

[ @account_name = ] 'account_name'

Nombre de la cuenta que se va a eliminar. @account_name es sysname, con un valor predeterminado de NULL. Puede especificarse el @account_id o el @account_name .

Valores de código de retorno

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

Conjunto de resultados

Ninguno.

Comentarios

Devuelve un error si la cuenta especificada no está asociada al perfil especificado.

Cuando se especifica una cuenta pero no se especifica ningún perfil, este procedimiento almacenado quita la cuenta especificada de todos los perfiles. Por ejemplo, si está preparando para apagar un servidor SMTP existente, quite las cuentas que usan ese servidor SMTP de todos los perfiles, en lugar de quitar cada cuenta de cada perfil.

Cuando se especifica un perfil pero no se especifica ninguna cuenta, este procedimiento almacenado quita todas las cuentas del perfil especificado. Por ejemplo, si va a cambiar los servidores SMTP que usa un perfil, puede ser conveniente quitar todas las cuentas del perfil y, a continuación, agregar nuevas cuentas según sea necesario.

El procedimiento sysmail_delete_profileaccount_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

El ejemplo siguiente muestra cómo se quita la cuenta Audit Account del perfil AdventureWorks Administrator.

EXEC msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account';