Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
SQL ServerAzure SQL Managed Instance
Hiermee maakt u een nieuw Database Mail-account met informatie over een SMTP-account.
Transact-SQL syntaxis-conventies
Syntaxis
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 ]
[ ; ]
Argumenten
[ @account_name = ] 'account_name'
De naam van het account dat u wilt toevoegen. @account_name is sysname, zonder standaardwaarde.
[ @email_address = ] 'email_address'
Het e-mailadres van waaruit het bericht moet worden verzonden. Dit adres moet een internet-e-mailadres zijn.
@email_address is nvarchar(128), zonder standaardinstelling. Een account voor SQL Server Agent kan bijvoorbeeld e-mail verzenden vanaf het adres SqlAgent@adventure-works.com.
[ @display_name = ] 'display_name'
De weergavenaam die moet worden gebruikt voor e-mailberichten van dit account.
@display_name is nvarchar(128), met een standaardwaarde van NULL. Een account voor SQL Server Agent kan bijvoorbeeld de naam SQL Server Agent Automated Mailer voor e-mailberichten weergeven.
[ @replyto_address = ] 'replyto_address'
Het adres waarnaar wordt gereageerd op berichten van dit account, wordt verzonden naar.
@replyto_address is nvarchar(128), met een standaardwaarde van NULL. Antwoorden op een account voor SQL Server Agent kunnen bijvoorbeeld naar de databasebeheerder danw@adventure-works.comgaan.
[ @description = ] 'beschrijving'
Een beschrijving voor het account.
@description is nvarchar(256), met een standaardwaarde van NULL.
[ @mailserver_name = ] 'server_name'
De naam of het IP-adres van de SMTP-e-mailserver die voor dit account moet worden gebruikt. De computer waarop SQL Server wordt uitgevoerd, moet de @mailserver_name kunnen oplossen naar een IP-adres. @mailserver_name is sysname, zonder standaardinstelling.
[ @mailserver_type = ] 'server_type'
Het type e-mailserver.
@mailserver_type is sysname, met een standaardwaarde van SMTP.
[ @port = ] port_number
Het poortnummer voor de e-mailserver.
@port is int, met een standaardwaarde van 25.
[ @username = ] 'gebruikersnaam'
De gebruikersnaam die moet worden gebruikt om u aan te melden bij de e-mailserver.
@username is nvarchar(128), met een standaardwaarde van NULL. Als deze parameter is NULL, gebruikt Database Mail geen verificatie voor dit account. Als voor de e-mailserver geen verificatie is vereist, gebruikt NULL u deze voor de gebruikersnaam.
[ @password = ] 'wachtwoord'
Het wachtwoord dat moet worden gebruikt om u aan te melden bij de e-mailserver.
@password is nvarchar(128), met een standaardwaarde van NULL. U hoeft geen wachtwoord op te geven, tenzij er een gebruikersnaam is opgegeven.
[ @use_default_credentials = ] use_default_credentials
Hiermee geeft u op of de e-mail naar de SMTP-server moet worden verzonden met behulp van de referenties van de SQL Server Database Engine.
@use_default_credentials is bit, met een standaardwaarde van 0. Wanneer deze parameter is 1, gebruikt Database Mail de referenties van de database-engine. Als deze parameter is 0, verzendt Database Mail de parameters @username en @password indien aanwezig, anders verzendt e-mail zonder @username en @password parameters.
[ @enable_ssl = ] enable_ssl
Hiermee geeft u op of Database Mail communicatie versleutelt met behulp van Secure Sockets Layer.
@enable_ssl is bit, met een standaardwaarde van 0.
[ @account_id = ] account_id UITVOER
Retourneert de account-id voor het nieuwe account.
@account_id is int, met een standaardwaarde van NULL.
Codewaarden retourneren
0 (geslaagd) of 1 (mislukt).
Opmerkingen
Database Mail biedt afzonderlijke parameters voor @email_address, @display_name en @replyto_address. De parameter @email_address is het adres van waaruit het bericht wordt verzonden. De parameter @display_name is de naam die wordt weergegeven in het From: veld van het e-mailbericht. De parameter @replyto_address is het adres waar antwoorden op het e-mailbericht worden verzonden. Een account dat wordt gebruikt voor SQL Server Agent kan bijvoorbeeld e-mailberichten verzenden vanaf een e-mailadres dat alleen wordt gebruikt voor SQL Server Agent. Berichten van dat adres moeten een beschrijvende naam bevatten, zodat geadresseerden eenvoudig kunnen bepalen dat SQL Server Agent het bericht heeft verzonden. Als een geadresseerde het bericht beantwoordt, moet het antwoord naar de databasebeheerder gaan in plaats van het adres dat door SQL Server Agent wordt gebruikt. Voor dit scenario wordt het account gebruikt SqlAgent@adventure-works.com als het e-mailadres. De weergavenaam is ingesteld op SQL Server Agent Automated Mailer. Het account gebruikt danw@adventure-works.com als antwoordadres, dus antwoorden op berichten die vanuit dit account worden verzonden, gaan naar de databasebeheerder in plaats van het e-mailadres voor SQL Server Agent. Door onafhankelijke instellingen voor deze drie parameters op te geven, kunt u met Database Mail berichten naar wens configureren.
De parameter @mailserver_type ondersteunt de waarde SMTP.
Wanneer @use_default_credentials is 1, wordt e-mail verzonden naar de SMTP-server met behulp van de referenties van de SQL Server Database Engine. Wanneer @use_default_credentials is 0 en een @username en @password zijn opgegeven voor een account, gebruikt het account SMTP-verificatie. De @username en @password zijn de referenties die het account gebruikt voor de SMTP-server, niet referenties voor SQL Server of het netwerk waarop de computer zich bevindt.
De opgeslagen procedure sysmail_add_account_sp bevindt zich in de msdb database en is eigendom van het dbo schema. De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.
Machtigingen
U kunt EXECUTE machtigingen verlenen voor deze procedure, maar deze machtigingen worden mogelijk overschreven tijdens een SQL Server-upgrade.
Voorbeelden
In het volgende voorbeeld wordt een account met de naam AdventureWorks Administratorgemaakt. Het account gebruikt het e-mailadres dba@adventure-works.com en verzendt e-mail naar de SMTP-e-mailserver smtp.adventure-works.com. E-mailberichten die vanuit dit account worden verzonden, worden weergegeven AdventureWorks Automated Mailer op de From: regel van het bericht. Antwoorden op de berichten worden doorgestuurd naar 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';