sysmail_update_account_sp (Transact-SQL)

Aplica-se a:SQL Server

Altera as informações em uma conta existente do Correio de Base de Dados.

Transact-SQL convenções de sintaxe

Sintaxe

dbo.sysmail_update_account_sp
    [ [ @account_id = ] account_id ]
    [ , [ @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 ]
    [ , [ @timeout = ] timeout ]
    [ , [ @no_credential_change = ] no_credential_change ]
[ ; ]

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 = ] N'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 = ] N'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 Correio de Base de Dados usa para enviar emails dessa conta. @email_address é nvarchar(128), com um padrão de NULL.

[ @display_name = ] N'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 = ] N'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 = ] N'descrição'

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

[ @mailserver_name = ] N'mailserver_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 = ] N'mailserver_type'

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

[ @port = ] porta

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

[ @username = ] N'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 [ = ] N'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 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 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 Correio de Base de Dados 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.

[ @timeout = ] tempo morto

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

[ @no_credential_change = ] no_credential_change

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

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