Sdílet prostřednictvím


sysmail_update_account_sp (Transact-SQL)

platí pro:SQL Server

Změní informace v existujícím databázovém účtu pošty.

Transact-SQL konvence syntaxe

Syntaxe

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

[ @account_id = ] account_id

ID účtu, které chcete aktualizovat. @account_id je int s výchozím nastavením NULL. Je třeba zadat alespoň jeden z @account_id nebo @account_name . Pokud jsou oba zadány, postup změní název účtu.

[ @account_name = ] 'account_name'

Název účtu, který chcete aktualizovat. @account_name je sysname, s výchozím nastavením NULL. Je třeba zadat alespoň jeden z @account_id nebo @account_name . Pokud jsou oba zadány, postup změní název účtu.

[ @email_address = ] 'email_address'

Nová e-mailová adresa, ze které chcete zprávu odeslat. Tato adresa musí být internetová e-mailová adresa. Název serveru v adrese je server, který databázová pošta používá k odesílání pošty z tohoto účtu. @email_address je nvarchar(128), s výchozím nastavením NULL.

[ @display_name = ] 'display_name'

Nový zobrazovaný název, který se použije u e-mailových zpráv z tohoto účtu. @display_name je nvarchar(128), bez výchozího nastavení.

[ @replyto_address = ] 'replyto_address'

Nová adresa, která se má použít v záhlaví Reply-To e-mailových zpráv z tohoto účtu. @replyto_address je nvarchar(128) bez výchozího nastavení.

[ @description = ] 'popis'

Nový popis účtu. @description je nvarchar(256) s výchozím nastavením NULL.

[ @mailserver_name = ] 'server_name'

Nový název poštovního serveru SMTP, který se má použít pro tento účet. Počítač se systémem SQL Server musí být schopen přeložit @mailserver_name na IP adresu. @mailserver_name je sysname bez výchozího nastavení.

[ @mailserver_type = ] 'server_type'

Nový typ poštovního serveru. @mailserver_type je sysname bez výchozího nastavení. Podporuje se jenom hodnota SMTP .

[ @port = ] port_number

Nové číslo portu poštovního serveru. @port je int, bez výchozího nastavení.

[ @timeout = ] 'timeout'

Parametr časového limitu pro SmtpClient.Send jednu e-mailovou zprávu @timeout je int v sekundách, bez výchozího nastavení.

[ @username = ] 'username'

Nové uživatelské jméno, které se má použít pro přihlášení k poštovnímu serveru. @username je sysname bez výchozího nastavení.

[ @password = ] 'password'

Nové heslo, které se použije k přihlášení k poštovnímu serveru. @password je sysname , bez výchozího nastavení.

[ @use_default_credentials = ] use_default_credentials

Určuje, zda se má pošta odeslat na server SMTP pomocí přihlašovacích údajů služby databázového stroje SQL Serveru. @use_default_credentials je bit, bez výchozího nastavení. Pokud je tento parametr 1, použije databázová pošta přihlašovací údaje databázového stroje. Pokud je tento parametr 0, použije databázová pošta k ověřování na serveru SMTP @username a @password . Pokud jsou @username a @passwordNULL, použije anonymní ověřování. Před zadáním tohoto parametru se obraťte na správce SMTP.

[ @enable_ssl = ] enable_ssl

Určuje, jestli databázová pošta šifruje komunikaci pomocí protokolu TLS (Transport Layer Security), dříve označovaného jako SSL (Secure Sockets Layer). Tuto možnost použijte, pokud je na serveru SMTP vyžadován protokol TLS. @enable_ssl je bit, bez výchozího nastavení.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Pokud je zadán název účtu i ID účtu, změní uložená procedura název účtu kromě aktualizace informací o účtu. Změna názvu účtu je užitečná k opravě chyb v názvu účtu.

Uložená procedura sysmail_update_account_sp je v msdb databázi a je vlastněna schématem dbo . Pokud aktuální databáze není msdb, je nutné provést postup se třemi částmi.

Povolení

K tomuto postupu můžete udělit oprávnění EXECUTE, ale tato oprávnění se můžou při upgradu SQL Serveru přepsat.

Příklady

A. Změna informací o účtu

Následující příklad aktualizuje účet AdventureWorks Administrator v msdb databázi. Informace pro účet jsou nastaveny na zadané hodnoty.

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. Změna názvu účtu a informací o účtu

Následující příklad změní název a aktualizuje informace o účtu pro ID 125účtu . Nový název účtu je 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;