Share via


sysmail_help_account_sp (Transact-SQL)

Lista informações (exceto senhas) sobre contas do Database Mail.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]

Argumentos

  • [ @account_id = ] account_id
    O ID da conta para a qual as informações serão listadas. account_id é int, com um padrão NULL.

  • [ @account_name = ] 'account_name'
    O nome da conta para a qual as informações serão listadas. account_name é sysname, com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Retorna um conjunto de resultados que contém as colunas listadas a seguir.

Nome da coluna

Tipo de dados

Descrição

account_id

int

O ID da conta.

name

sysname

O nome da conta.

description

nvarchar(256)

A descrição da conta.

email_address

nvarchar(128)

O endereço de email a partir do qual as mensagens serão enviadas.

display_name

nvarchar(128)

O nome para exibição da conta.

replyto_address

nvarchar(128)

O endereço onde as respostas às mensagens desta conta são enviadas.

servertype

sysname

O tipo de servidor de email da conta.

servername

sysname

O nome do servidor de email da conta.

port

int

O número da porta usada pelo servidor de email.

username

nvarchar(128)

O nome de usuário a ser usado para fazer logon no servidor de email, se o servidor de email usar autenticação. Quando username for NULL, o Database Mail não usa autenticação para esta conta.

use_default_credentials

bit

Especifica se o email deve ser enviado para o servidor SMTP usando as credenciais do Mecanismo de banco de dados do SQL Server. use_default_credentials é bit, sem padrão. Quando este parâmetro for 1, o Database Mail usa as credenciais do serviço Mecanismo de banco de dados do SQL Server. Quando este parâmetro for 0, o Database Mail usa @username e @password para autenticação no servidor SMTP. Se @username e @password forem NULL, o Database Mail usará autenticação anônima. Consulte o administrador de SMTP antes de especificar este parâmetro.

enable_ssl

bit

Especifica se o Database Mail criptografa a comunicação usando o Protocolo SSL. Use esta opção se o SSL for necessário em seu servidor SMTP. enable_ssl é bit, sem padrão. 1 indica que o Database Mail criptografa a comunicação usando SSL. 0 indica que o Database Mail envia o email sem criptografia SSL.

Comentários

Quando nenhum account_id ou account_name for fornecido, sysmail_help_account listará informações sobre todas as contas do Database Mail na instância do Microsoft SQL Server.

O procedimento armazenado sysmail_help_account_sp está no banco de dados msdb e pertence ao 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

A. Listando as informações de todas as contas

O exemplo a seguir mostra a lista de informações de conta para todas as contas na instância.

EXECUTE msdb.dbo.sysmail_help_account_sp ;

Conjunto de resultados de exemplo, editado para comprimento de linha:

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      
149         Audit Account                Account for audit e-mail.               audit@Adventure-Works.com Automated Mailer (Audit)         NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      

B. Listando as informações de uma conta específica

O exemplo a seguir mostra a lista de informações de conta para a conta denominada AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks2008R2 Administrator' ;

Conjunto de resultados de exemplo, editado para comprimento de linha:

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0