Partilhar via

sysmail_update_account_sp (Transact-SQL)

Aplica-se a:SQL Server

Altera as informações em uma conta existente do Database Mail.

Transact-SQL convenções de sintaxe

Sintaxe

sysmail_update_account_sp [ [ @account_id = ] account_id ] [ , ] [ [ @account_name = ] 'account_name' ]
    , [ @email_address = ] 'email_address'
    , [ @display_name = ] 'display_name'
    , [ @replyto_address = ] 'replyto_address'
    , [ @description = ] 'description'
    , [ @mailserver_name = ] 'server_name'
    , [ @mailserver_type = ] 'server_type'
    , [ @port = ] port_number
    , [ @timeout = ] 'timeout'
    , [ @username = ] 'username'
    , [ @password = ] 'password'
    , [ @use_default_credentials = ] use_default_credentials
    , [ @enable_ssl = ] enable_ssl
[ ; ]

Argumentos

@account_id [ = ] account_id

O ID da conta a ser atualizado. @account_id é int, com um padrão de NULL. Pelo menos um dos @account_id ou @account_name deve ser especificado. Se ambos forem especificados, o procedimento alterará o nome da conta.

@account_name [ = ] «account_name»

O nome da conta a ser atualizada. @account_name é sysname, com um padrão de NULL. Pelo menos um dos @account_id ou @account_name deve ser especificado. Se ambos forem especificados, o procedimento alterará o nome da conta.

@email_address [ = ] «email_address»

O novo 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. O nome do servidor no endereço é o servidor que o Database Mail usa para enviar emails dessa conta. @email_address é nvarchar(128), com um padrão de NULL.

@display_name [ = ] «display_name»

O novo nome para exibição a ser usado em mensagens de email dessa conta. @display_name é nvarchar(128), sem padrão.

@replyto_address [ = ] «replyto_address»

O novo endereço a ser usado no cabeçalho Reply-To de mensagens de email dessa conta. @replyto_address é nvarchar(128), sem padrão.

[ @description = ] 'descrição'

A nova descrição da conta. @description é nvarchar(256), com um padrão de NULL.

@mailserver_name [ = ] «server_name»

O novo nome 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 [ = ] «server_type»

O novo tipo de servidor de email. @mailserver_type é sysname, sem padrão. Apenas um valor de é suportado SMTP .

@port [ = ] port_number

O novo número de porta do servidor de email. @port é int, sem padrão.

@timeout [ = ] 'tempo limite'

Parâmetro de tempo limite para SmtpClient.Send uma única mensagem de e-mail. @timeout é int em segundos, sem padrão.

@username [ = ] 'nome de utilizador'

O novo nome de usuário a ser usado para fazer logon no servidor de email. @username é sysname, sem padrão.

@password [ = ] 'senha'

A nova senha a ser usada para fazer logon no servidor de email. @password é sysname, sem padrão.

@use_default_credentials [ = ] use_default_credentials

Especifica se o email deve ser enviado para o servidor SMTP usando as credenciais do serviço Mecanismo de Banco de Dados do SQL Server. @use_default_credentials é pouco, sem padrão. Quando esse parâmetro é 1, o Database Mail usa as credenciais do Mecanismo de Banco de Dados. 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, ele usa autenticação anônima. Consulte o administrador SMTP antes de especificar este parâmetro

@enable_ssl [ = ] enable_ssl

Especifica se o Database Mail criptografa a comunicação usando TLS (Transport Layer Security), anteriormente conhecido como SSL (Secure Sockets Layer). Use esta opção se o TLS for necessário no seu servidor SMTP. @enable_ssl é pouco, sem padrão.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

Quando o nome da conta e o ID da conta são especificados, o procedimento armazenado altera o nome da conta, além de atualizar as informações da conta. Alterar o nome da conta é útil para corrigir erros no nome da conta.

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

Um. Alterar as informações de uma conta

O exemplo a AdventureWorks Administrator seguir atualiza a conta msdb no banco de dados. As informações da conta são definidas com os valores fornecidos.

EXECUTE msdb.dbo.sysmail_update_account_sp
    @account_name = 'AdventureWorks Administrator',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@adventure-works.com',
    @display_name = 'AdventureWorks Automated Mailer',
    @replyto_address = NULL,
    @mailserver_name = 'smtp.adventure-works.com',
    @mailserver_type = 'SMTP',
    @port = 25,
    @timeout = 60,
    @username = NULL,
    @password = NULL,
    @use_default_credentials = 0,
    @enable_ssl = 0;

B. Alterar o nome de uma conta e as informações de uma conta

O exemplo a seguir altera o nome e atualiza as informações da conta para o com ID 125de conta . O novo nome da conta é Backup Mail Server.

EXECUTE msdb.dbo.sysmail_update_account_sp
    @account_id = 125,
    @account_name = 'Backup Mail Server',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@adventure-works.com',
    @display_name = 'AdventureWorks Automated Mailer',
    @replyto_address = NULL,
    @mailserver_name = 'smtp-backup.adventure-works.com',
    @mailserver_type = 'SMTP',
    @port = 25,
    @timeout = 60,
    @username = NULL,
    @password = NULL,
    @use_default_credentials = 0,
    @enable_ssl = 0;

Conteúdo relacionado

  • Last updated on