Partilhar via


sysmail_help_account_sp (Transact-SQL)

Aplica-se a: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@account_id [ = ] account_id

A ID da conta para a qual as informações serão listadas. @account_id é int, com um padrão de NULL.

@account_name [ = ] 'account_name'

O nome da conta para a qual listar informações. @account_name é sysname, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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 é NULL, o Database Mail não usa autenticação para essa 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. Quando esse parâmetro é 1, o Database Mail usa as credenciais do serviço Mecanismo de Banco de Dados do SQL Server. Quando esse parâmetro é 0, o Database Mail usa o @username e o @password para autenticação no servidor SMTP. Se @username e @password forem NULL, o Database Mail usará autenticação anônima. Consulte o administrador do SMTP antes de especificar esse parâmetro.
enable_ssl bit Especifica se o Database Mail criptografa a comunicação usando o Transport Layer Security (TLS), anteriormente conhecido como Secure Sockets Layer (SSL). Use essa opção se o TLS for necessário em seu servidor SMTP. 1 indica que o Database Mail criptografa a comunicação usando TLS. 0 indica que o Database Mail envia o e-mail sem criptografia TLS.

Comentários

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

O procedimento sysmail_help_account_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

R. Listar 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.

EXEC 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         AdventureWorks 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. Listar 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.

EXEC msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks 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         AdventureWorks Administrator Mail account for administrative e-mail. dba@adventure-works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.adventure-works.com  25          NULL     0                       0