sysmail_delete_profileaccount_sp (Transact-SQL)
Aplica-se a: SQL Server
Remove uma conta de um perfil do Database Mail.
Convenções de sintaxe de Transact-SQL
Sintaxe
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
A ID do perfil a ser excluído. @profile_id é int, com um padrão de NULL
. O @profile_id ou o @profile_name podem ser especificados.
@profile_name [ = ] 'profile_name'
O nome do perfil a ser excluído. @profile_name é sysname, com um padrão de NULL
. O @profile_id ou o @profile_name podem ser especificados.
@account_id [ = ] account_id
O ID da conta a ser excluída. @account_id é int, com um padrão de NULL
. O @account_id ou o @account_name podem ser especificados.
@account_name [ = ] 'account_name'
O nome da conta a ser excluída. @account_name é sysname, com um padrão de NULL
. O @account_id ou o @account_name podem ser especificados.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Nenhum.
Comentários
Retorna um erro se a conta especificada não estiver associada ao perfil especificado.
Quando é especificada uma conta, mas não um perfil, esse procedimento armazenado remove a conta especificada de todos os perfis. Por exemplo, se você estiver se preparando para desligar um servidor SMTP existente, remova as contas que usam esse servidor SMTP de todos os perfis, em vez de remover cada conta de cada perfil.
Quando um perfil é especificado, mas não uma conta, esse procedimento armazenado remove todas as contas do perfil especificado. Por exemplo, se você estiver alterando os servidores SMTP que um perfil usa, pode ser conveniente remover todas as contas do perfil e adicionar novas contas conforme necessário.
O procedimento sysmail_delete_profileaccount_sp
armazenado está no msdb
banco de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdb
for .
Permissões
Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE
permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Exemplos
O exemplo a seguir mostra a remoção da conta Audit Account
do perfil AdventureWorks Administrator
.
EXEC msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account';