Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL ServerAzure SQL Managed Instance
Cria uma nova conta do Correio de Base de Dados que contém informações sobre uma conta SMTP.
Transact-SQL convenções de sintaxe
Sintaxe
dbo.sysmail_add_account_sp
[ @account_name = ] N'account_name'
, [ @email_address = ] N'email_address'
[ , [ @display_name = ] N'display_name' ]
[ , [ @replyto_address = ] N'replyto_address' ]
[ , [ @description = ] N'description' ]
[ , [ @mailserver_name = ] N'mailserver_name' ]
[ , [ @mailserver_type = ] N'mailserver_type' ]
[ , [ @port = ] port ]
[ , [ @username = ] N'username' ]
[ , [ @password = ] N'password' ]
[ , [ @use_default_credentials = ] use_default_credentials ]
[ , [ @enable_ssl = ] enable_ssl ]
[ , [ @account_id = ] account_id OUTPUT ]
[ ; ]
Argumentos
[ @account_name = ] N'account_name'
O nome da conta a ser adicionada. @account_name é sysname, sem padrão.
[ @email_address = ] N'email_address'
O endereço de e-mail a partir do qual enviar a mensagem. Este endereço deve ser um endereço de correio eletrónico na Internet.
@email_address é nvarchar(128), sem padrão. Por exemplo, uma conta do SQL Server Agent pode enviar email do endereço SqlAgent@adventure-works.com.
[ @display_name = ] N'display_name'
O nome para exibição a ser usado em mensagens de email dessa conta.
@display_name é nvarchar(128), com um padrão de NULL. Por exemplo, uma conta do SQL Server Agent pode exibir o nome SQL Server Agent Automated Mailer em mensagens de email.
[ @replyto_address = ] N'replyto_address'
O endereço para o qual as respostas às mensagens dessa conta são enviadas.
@replyto_address é nvarchar(128), com um padrão de NULL. Por exemplo, as respostas a uma conta do SQL Server Agent podem ir para o administrador do banco de dados, danw@adventure-works.com.
[ @description = ] N'descrição'
Uma descrição para a conta.
@description é nvarchar(256), com um padrão de NULL.
[ @mailserver_name = ] N'mailserver_name'
O nome ou endereço IP do servidor de correio SMTP a utilizar para esta conta. O computador que executa o SQL Server deve ser capaz de resolver o @mailserver_name para um endereço IP. @mailserver_name é sysname, sem padrão.
[ @mailserver_type = ] N'mailserver_type'
O tipo de servidor de e-mail.
@mailserver_type é sysname, com um padrão de SMTP.
[ @port = ] porta
O número da porta do servidor de email.
@port é int, com um padrão de 25.
[ @username = ] N'nome de utilizador'
O nome de usuário a ser usado para fazer logon no servidor de email.
@username é nvarchar(128), com um padrão de NULL. Quando esse parâmetro é NULL, o Correio de Base de Dados não usa autenticação para essa conta. Se o servidor de email não exigir autenticação, use NULL para o nome de usuário.
@password [ = ] N'senha'
A palavra-passe a utilizar para iniciar sessão no servidor de correio eletrónico.
@password é nvarchar(128), com um padrão de NULL. Não há necessidade de fornecer uma senha, a menos que um nome de usuário seja especificado.
@use_default_credentials [ = ] use_default_credentials
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, com um padrão de 0. Quando esse parâmetro é 1, o Correio de Base de Dados usa as credenciais do Mecanismo de Banco de Dados. Quando esse parâmetro é 0, o Correio de Base de Dados envia os parâmetros @username e @password , se presentes, caso contrário, envia emails sem @username e @password parâmetros.
@enable_ssl [ = ] enable_ssl
Especifica se o Correio de Base de Dados criptografa a comunicação usando o Secure Sockets Layer.
@enable_ssl é bit, com um padrão de 0.
@account_id [ = ] account_id SAÍDA
Devolve o ID da conta para a nova conta.
@account_id é int, com um padrão de NULL.
Valores de código de retorno
0 (sucesso) ou 1 (fracasso).
Observações
O Correio de Base de Dados fornece parâmetros separados para @email_address, @display_name e @replyto_address. O parâmetro @email_address é o endereço a partir do qual a mensagem é enviada. O parâmetro @display_name é o nome mostrado no From: campo da mensagem de email. O parâmetro @replyto_address é o endereço para onde as respostas à mensagem de email serão enviadas. Por exemplo, uma conta usada para o SQL Server Agent pode enviar mensagens de email de um endereço de email usado apenas para o SQL Server Agent. As mensagens desse endereço devem exibir um nome amigável, para que os destinatários possam determinar facilmente que o SQL Server Agent enviou a mensagem. Se um destinatário responder à mensagem, a resposta deverá ir para o administrador do banco de dados em vez do endereço usado pelo SQL Server Agent. Para esse cenário, a conta usa SqlAgent@adventure-works.com como o endereço de email. O nome para exibição é definido como SQL Server Agent Automated Mailer. A conta usa danw@adventure-works.com como endereço de resposta, portanto, as respostas às mensagens enviadas dessa conta vão para o administrador do banco de dados em vez do endereço de email do SQL Server Agent. Ao fornecer configurações independentes para esses três parâmetros, o Correio de Base de Dados permite que você configure mensagens para atender às suas necessidades.
O parâmetro @mailserver_type suporta o valor SMTP.
Quando @use_default_credentials é 1, o email é enviado para o servidor SMTP usando as credenciais do Mecanismo de Banco de Dados do SQL Server. Quando @use_default_credentials é 0 e um @username e @password são especificados para uma conta, a conta usa a autenticação SMTP. O @username e @password são as credenciais que a conta usa para o servidor SMTP, não credenciais para o SQL Server ou a rede em que o computador está.
O procedimento sysmail_add_account_sp armazenado está no msdb banco de dados e pertence ao dbo esquema. O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdbfor .
Permissões
Você pode conceder permissões de EXECUTE neste procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Exemplos
O exemplo a seguir cria uma conta chamada AdventureWorks Administrator. A conta utiliza o endereço dba@adventure-works.com de correio eletrónico e envia correio para o servidor smtp.adventure-works.comde correio SMTP . As mensagens de correio eletrónico enviadas a partir desta conta são apresentadas AdventureWorks Automated Mailer na From: linha da mensagem. As respostas às mensagens são direcionadas para danw@adventure-works.com.
EXECUTE msdb.dbo.sysmail_add_account_sp
@account_name = 'AdventureWorks Administrator',
@description = 'Mail account for administrative e-mail.',
@email_address = 'dba@adventure-works.com',
@display_name = 'AdventureWorks Automated Mailer',
@mailserver_name = 'smtp.adventure-works.com';