sysmail_help_account_sp (Transact-SQL)
Lista informações (exceto senhas) sobre contas do Database Mail.
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
Consulte também