Dela via


sysmail_update_account_sp (Transact-SQL)

gäller för:SQL Server

Ändrar informationen i ett befintligt Database Mail-konto.

Transact-SQL syntaxkonventioner

Syntax

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

Argumentpunkter

[ @account_id = ] account_id

Det konto-ID som ska uppdateras. @account_id är int, med standardvärdet NULL. Minst en av @account_id eller @account_name måste anges. Om båda anges ändrar proceduren namnet på kontot.

[ @account_name = ] "account_name"

Namnet på det konto som ska uppdateras. @account_name är sysname med standardvärdet NULL. Minst en av @account_id eller @account_name måste anges. Om båda anges ändrar proceduren namnet på kontot.

[ @email_address = ] "email_address"

Den nya e-postadressen som meddelandet ska skickas från. Den här adressen måste vara en e-postadress på Internet. Servernamnet i adressen är den server som Database Mail använder för att skicka e-post från det här kontot. @email_address är nvarchar(128), med standardvärdet NULL.

[ @display_name = ] "display_name"

Det nya visningsnamnet som ska användas för e-postmeddelanden från det här kontot. @display_name är nvarchar(128), utan standard.

[ @replyto_address = ] "replyto_address"

Den nya adressen som ska användas i Reply-To-rubriken för e-postmeddelanden från det här kontot. @replyto_address är nvarchar(128), utan standard.

[ @description = ] "beskrivning"

Den nya beskrivningen för kontot. @description är nvarchar(256), med standardvärdet NULL.

[ @mailserver_name = ] "server_name"

Det nya namnet på SMTP-e-postservern som ska användas för det här kontot. Datorn som kör SQL Server måste kunna matcha @mailserver_name till en IP-adress. @mailserver_name är sysname, utan standard.

[ @mailserver_type = ] "server_type"

Den nya typen av e-postserver. @mailserver_type är sysname, utan standard. Endast ett värde för SMTP stöds.

[ @port = ] port_number

E-postserverns nya portnummer. @port är int, utan standard.

[ @timeout = ] "timeout"

Timeout-parameter för SmtpClient.Send ett enda e-postmeddelande. @timeout är int i sekunder, utan standard.

[ @username = ] "användarnamn"

Det nya användarnamnet som ska användas för att logga in på e-postservern. @username är sysname, utan standard.

[ @password = ] "lösenord"

Det nya lösenordet som ska användas för att logga in på e-postservern. @password är sysname, utan standard.

[ @use_default_credentials = ] use_default_credentials

Anger om e-postmeddelandet ska skickas till SMTP-servern med autentiseringsuppgifterna för SQL Server Database Engine-tjänsten. @use_default_credentials är bit, utan standard. När den här parametern är 1 använder Database Mail databasmotorns autentiseringsuppgifter. När den här parametern är 0 använder Database Mail @username och @password för autentisering på SMTP-servern. Om @username och @password är NULLanvänder den anonym autentisering. Kontakta SMTP-administratören innan du anger den här parametern

[ @enable_ssl = ] enable_ssl

Anger om Database Mail krypterar kommunikationen med hjälp av TLS (Transport Layer Security), som tidigare kallades Secure Sockets Layer (SSL). Använd det här alternativet om TLS krävs på SMTP-servern. @enable_ssl är bit, utan standard.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

När både kontonamnet och konto-ID:t har angetts ändrar den lagrade proceduren kontonamnet förutom att uppdatera informationen för kontot. Det är användbart att ändra kontonamnet för att korrigera fel i kontonamnet.

Den lagrade proceduren sysmail_update_account_sp finns i msdb databasen och ägs av dbo schemat. Proceduren måste köras med ett namn i tre delar om den aktuella databasen inte msdbär .

Behörigheter

Du kan bevilja EXECUTE behörigheter för den här proceduren, men dessa behörigheter kan åsidosättas under en SQL Server-uppgradering.

Exempel

A. Ändra informationen för ett konto

I följande exempel uppdateras kontot AdventureWorks Administrator i msdb databasen. Informationen för kontot anges till de angivna värdena.

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. Ändra namnet på ett konto och informationen för ett konto

I följande exempel ändras namnet och kontoinformationen uppdateras för med konto-ID 125. Det nya namnet på kontot är 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;