sysmail_update_account_sp (Transact-SQL)

Dotyczy:SQL Server

Zmienia informacje na istniejącym koncie poczty bazy danych.

Transact-SQL konwencje składni

Składnia

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
[ ; ]

Argumenty (w programowaniu)

[ @account_id = ] account_id

Identyfikator konta do zaktualizowania. @account_id jest int z wartością domyślną NULL. Należy określić co najmniej jedną z @account_id lub @account_name . Jeśli oba te elementy zostaną określone, procedura zmieni nazwę konta.

[ @account_name = ] 'account_name'

Nazwa konta do zaktualizowania. @account_name to nazwa systemu z wartością domyślną NULL. Należy określić co najmniej jedną z @account_id lub @account_name . Jeśli oba te elementy zostaną określone, procedura zmieni nazwę konta.

[ @email_address = ] 'email_address'

Nowy adres e-mail do wysłania wiadomości. Ten adres musi być adresem e-mail internetowym. Nazwa serwera w adresie jest serwerem używanym przez pocztę bazy danych do wysyłania poczty z tego konta. @email_address to nvarchar(128), z wartością domyślną NULL.

[ @display_name = ] 'display_name'

Nowa nazwa wyświetlana do użycia w wiadomościach e-mail z tego konta. @display_name to nvarchar(128), bez wartości domyślnej.

[ @replyto_address = ] 'replyto_address'

Nowy adres do użycia w nagłówku Reply-To wiadomości e-mail z tego konta. @replyto_address to nvarchar(128), bez wartości domyślnej.

[ @description = ] "opis"

Nowy opis konta. @description to nvarchar(256), z wartością domyślną NULL.

[ @mailserver_name = ] 'server_name'

Nowa nazwa serwera poczty SMTP do użycia dla tego konta. Komputer z uruchomionym programem SQL Server musi mieć możliwość rozpoznania @mailserver_name na adres IP. @mailserver_name to nazwa systemu bez wartości domyślnej.

[ @mailserver_type = ] 'server_type'

Nowy typ serwera poczty. @mailserver_type jest nazwą systemu bez wartości domyślnej. Obsługiwana SMTP jest tylko wartość .

[ @port = ] port_number

Nowy numer portu serwera poczty. @port jest int bez wartości domyślnej.

[ @timeout = ] "limit czasu"

Parametr limitu czasu pojedynczej SmtpClient.Send wiadomości e-mail. @timeout jest int w sekundach, bez wartości domyślnej.

[ @username = ] 'username'

Nowa nazwa użytkownika używana do logowania się na serwerze poczty. @username jest nazwą systemu bez wartości domyślnej.

[ @password = ] 'password'

Nowe hasło, które ma być używane do logowania się na serwerze poczty. @password jest nazwa_systemu, bez wartości domyślnej.

[ @use_default_credentials = ] use_default_credentials

Określa, czy wysyłać pocztę na serwer SMTP przy użyciu poświadczeń usługi aparatu bazy danych programu SQL Server. @use_default_credentials jest bit, bez wartości domyślnej. Jeśli ten parametr ma wartość 1, poczta bazy danych używa poświadczeń aparatu bazy danych. Gdy ten parametr ma wartość 0, poczta bazy danych używa @username i @password do uwierzytelniania na serwerze SMTP. Jeśli @username i @password to NULL, używa uwierzytelniania anonimowego. Przed określeniem tego parametru skontaktuj się z administratorem SMTP

[ @enable_ssl = ] enable_ssl

Określa, czy poczta bazy danych szyfruje komunikację przy użyciu protokołu Transport Layer Security (TLS), wcześniej znanego jako Secure Sockets Layer (SSL). Użyj tej opcji, jeśli protokół TLS jest wymagany na serwerze SMTP. @enable_ssl jest bit, bez wartości domyślnej.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Po określeniu zarówno nazwy konta, jak i identyfikatora konta procedura składowana zmienia nazwę konta oprócz aktualizowania informacji o koncie. Zmiana nazwy konta jest przydatna do poprawiania błędów w nazwie konta.

Procedura sysmail_update_account_sp składowana znajduje się w msdb bazie danych i jest własnością schematu dbo . Procedura musi być wykonywana z trzyczęściową nazwą, jeśli bieżąca baza danych nie msdbjest .

Uprawnienia

Możesz udzielić EXECUTE uprawnień do tej procedury, ale te uprawnienia mogą zostać zastąpione podczas uaktualniania programu SQL Server.

Przykłady

Odp. Zmienianie informacji dotyczących konta

Poniższy przykład aktualizuje konto AdventureWorks Administrator w msdb bazie danych. Informacje dotyczące konta są ustawione na podane wartości.

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. Zmienianie nazwy konta i informacji o koncie

Poniższy przykład zmienia nazwę i aktualizuje informacje o koncie dla elementu o identyfikatorze 125konta . Nowa nazwa konta to 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;

Treści powiązane

• Poczta bazy danych
• Tworzenie konta poczty bazy danych
• Procedury składowane poczty bazy danych (Transact-SQL)