Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
gäller för:
SQL ServerAzure SQL Managed Instance
Skapar ett nytt Database Mail-konto med information om ett SMTP-konto.
Transact-SQL syntaxkonventioner
Syntax
sysmail_add_account_sp [ @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 ]
[ , [ @username = ] 'username' ]
[ , [ @password = ] 'password' ]
[ , [ @use_default_credentials = ] use_default_credentials ]
[ , [ @enable_ssl = ] enable_ssl ]
[ , [ @account_id = ] account_id OUTPUT ]
[ ; ]
Argumentpunkter
[ @account_name = ] "account_name"
Namnet på det konto som ska läggas till. @account_name är sysname, utan standard.
[ @email_address = ] "email_address"
E-postadressen som meddelandet ska skickas från. Den här adressen måste vara en e-postadress på Internet.
@email_address är nvarchar(128), utan standard. Ett konto för SQL Server Agent kan till exempel skicka e-post från adressen SqlAgent@adventure-works.com.
[ @display_name = ] "display_name"
Visningsnamnet som ska användas för e-postmeddelanden från det här kontot.
@display_name är nvarchar(128), med standardvärdet NULL. Ett konto för SQL Server Agent kan till exempel visa namnet SQL Server Agent Automated Mailer på e-postmeddelanden.
[ @replyto_address = ] "replyto_address"
Adressen som svar på meddelanden från det här kontot skickas till.
@replyto_address är nvarchar(128), med standardvärdet NULL. Svar på ett konto för SQL Server Agent kan till exempel gå till databasadministratören. danw@adventure-works.com
[ @description = ] "beskrivning"
En beskrivning av kontot.
@description är nvarchar(256), med standardvärdet NULL.
[ @mailserver_name = ] "server_name"
Namnet eller IP-adressen för 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"
Typ av e-postserver.
@mailserver_type är sysname med standardvärdet SMTP.
[ @port = ] port_number
Portnumret för e-postservern.
@port är int, med standardvärdet 25.
[ @username = ] "användarnamn"
Användarnamnet som ska användas för att logga in på e-postservern.
@username är nvarchar(128), med standardvärdet NULL. När den här parametern är NULLanvänder Database Mail inte autentisering för det här kontot. Om e-postservern inte kräver autentisering använder du NULL för användarnamnet.
[ @password = ] "lösenord"
Lösenordet som ska användas för att logga in på e-postservern.
@password är nvarchar(128), med standardvärdet NULL. Du behöver inte ange ett lösenord om inte ett användarnamn har angetts.
[ @use_default_credentials = ] use_default_credentials
Anger om e-postmeddelandet ska skickas till SMTP-servern med autentiseringsuppgifterna för SQL Server Database Engine.
@use_default_credentials är bit, med standardvärdet 0. När den här parametern är 1använder Database Mail autentiseringsuppgifterna för databasmotorn. När den här parametern är 0skickar Database Mail parametrarna @username och @password om de finns, annars skickas e-post utan parametrarna @username och @password .
[ @enable_ssl = ] enable_ssl
Anger om Database Mail krypterar kommunikationen med secure sockets layer.
@enable_ssl är bit, med standardvärdet 0.
[ @account_id = ] account_id UTDATA
Returnerar konto-ID för det nya kontot.
@account_id är int, med standardvärdet NULL.
Returnera kodvärden
0 (lyckades) eller 1 (fel).
Anmärkningar
Database Mail innehåller separata parametrar för @email_address, @display_name och @replyto_address. Parametern @email_address är adressen som meddelandet skickas från. Parametern @display_name är namnet som visas i fältet i From: e-postmeddelandet. Parametern @replyto_address är adressen där svar på e-postmeddelandet skickas. Ett konto som används för SQL Server Agent kan till exempel skicka e-postmeddelanden från en e-postadress som endast används för SQL Server Agent. Meddelanden från den adressen ska visa ett eget namn, så att mottagarna enkelt kan avgöra att SQL Server-agenten skickade meddelandet. Om en mottagare svarar på meddelandet bör svaret gå till databasadministratören i stället för den adress som används av SQL Server Agent. I det här scenariot används SqlAgent@adventure-works.com kontot som e-postadress. Visningsnamnet är inställt på SQL Server Agent Automated Mailer. Kontot använder danw@adventure-works.com som svar på adress, så svar på meddelanden som skickas från det här kontot går till databasadministratören i stället för e-postadressen för SQL Server Agent. Genom att tillhandahålla oberoende inställningar för dessa tre parametrar kan du med Database Mail konfigurera meddelanden så att de passar dina behov.
Parametern @mailserver_type stöder värdet SMTP.
När @use_default_credentials är 1skickas e-post till SMTP-servern med autentiseringsuppgifterna för SQL Server Database Engine. När @use_default_credentials är 0 och en @username och @password anges för ett konto använder kontot SMTP-autentisering.
@username och @password är de autentiseringsuppgifter som kontot använder för SMTP-servern, inte autentiseringsuppgifter för SQL Server eller nätverket som datorn är på.
Den lagrade proceduren sysmail_add_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
I följande exempel skapas ett konto med namnet AdventureWorks Administrator. Kontot använder e-postadressen dba@adventure-works.com och skickar e-post till SMTP-e-postservern smtp.adventure-works.com. E-postmeddelanden som skickas från det här kontot visas AdventureWorks Automated Mailer på From: meddelanderaden. Svar på meddelandena dirigeras till danw@adventure-works.com.
EXECUTE msdb.dbo.sysmail_add_account_sp
@account_name = 'AdventureWorks Administrator',
@description = 'Mail account for administrative e-mail.',
@email_address = 'dba@adventure-works.com',
@display_name = 'AdventureWorks Automated Mailer',
@mailserver_name = 'smtp.adventure-works.com';