Compartilhar via


sysmail_delete_profileaccount_sp (Transact-SQL)

Remove uma conta de um perfil do Database Mail.

Ícone de vínculo de tópicoConvenções de sintaxe 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ída. profile_id é int, com um padrão NULL. Pode ser especificada a 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 NULL. Pode ser especificada a profile_id ou o profile_name.

  • [ @account_id = ] account_id
    A ID da conta a ser excluída. account_id é int, com um padrão NULL. Pode ser especificada a account_id ou o account_name.

  • [ @account_name = ] 'account_name'
    O nome da conta a ser excluído. account_name é sysname, com um padrão NULL. Pode ser especificada a account_id ou o account_name.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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, deverá remover 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 utiliza, pode ser conveniente remover todas as contas do perfil e, depois, adicionar novas contas conforme necessário.

O procedimento armazenado sysmail_delete_profileaccount_sp está no banco de dados msdb e é de propriedade do esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir mostra a remoção da conta Audit Account do perfil AdventureWorks Administrator.

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