Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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';