sysmail_update_account_sp (Transact-SQL)

gäller för:SQL Server

Ändrar informationen i ett befintligt Database Mail-konto.

Transact-SQL syntaxkonventioner

Syntax

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

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 = ] N'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 = ] N'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 = ] N'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 = ] N'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 = ] Nbeskrivning

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

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

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

[ @port = ] port

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

[ @username = ] N'användarnamn'

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

[ @password = ] Nlö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 Databasmotor för SQL Server-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.

[ @timeout = ] timeout

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

[ @no_credential_change = ] no_credential_change

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

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;