sysmail_delete_profileaccount_sp (Transact-SQL)

  • Artigo

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. Podem ser especificados o @profile_id ou o @profile_name.

@profile_name [ = ] 'profile_name'

O nome do perfil a ser excluído. @profile_name é sysname, com um padrão de NULL. Podem ser especificados o @profile_id ou o @profile_name.

@account_id [ = ] account_id

O ID da conta a ser excluída. @account_id é int, com um padrão de NULL. Podem ser especificados o @account_id ou o @account_name.

@account_name [ = ] 'account_name'

O nome da conta a ser excluída. @account_name é sysname, com um padrão de NULL. Podem ser especificados o @account_id ou o @account_name.

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, em seguida, 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 msdbfor .

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';

Conteúdo relacionado