Partilhar via


sysmail_delete_profileaccount_sp (Transact-SQL)

Remove uma conta de um perfil do Database Mail.

Ícone de vínculo de tópico Convenções da 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ído. profile_id é int, com um padrão de 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 de NULL. Pode ser especificada a 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. Pode ser especificada a 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. 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' ;

Consulte também

Referência

Procedimentos armazenados do Database Mail (Transact-SQL)

Conceitos

Database Mail

Criar uma conta do Database Mail

Objetos de configuração do Database Mail