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 Server
Hiermee wijzigt u de gegevens in een bestaand Database Mail-account.
Transact-SQL syntaxis-conventies
Syntaxis
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
[ ; ]
Argumenten
[ @account_id = ] account_id
De account-id die moet worden bijgewerkt.
@account_id is int, met een standaardwaarde van NULL. Ten minste één van @account_id of @account_name moet worden opgegeven. Als beide zijn opgegeven, wijzigt de procedure de naam van het account.
[ @account_name = ] 'account_name'
De naam van het account dat moet worden bijgewerkt.
@account_name is sysname, met een standaardwaarde van NULL. Ten minste één van @account_id of @account_name moet worden opgegeven. Als beide zijn opgegeven, wijzigt de procedure de naam van het account.
[ @email_address = ] 'email_address'
Het nieuwe e-mailadres waaruit het bericht moet worden verzonden. Dit adres moet een internet-e-mailadres zijn. De servernaam in het adres is de server die Database Mail gebruikt voor het verzenden van e-mail vanuit dit account.
@email_address is nvarchar(128), met een standaardwaarde van NULL.
[ @display_name = ] 'display_name'
De nieuwe weergavenaam die moet worden gebruikt voor e-mailberichten van dit account. @display_name is nvarchar(128), zonder standaardinstelling.
[ @replyto_address = ] 'replyto_address'
Het nieuwe adres dat moet worden gebruikt in de Reply-To koptekst van e-mailberichten van dit account. @replyto_address is nvarchar(128), zonder standaardwaarde.
[ @description = ] 'beschrijving'
De nieuwe beschrijving voor het account.
@description is nvarchar(256), met een standaardwaarde van NULL.
[ @mailserver_name = ] 'server_name'
De nieuwe naam 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 nieuwe type van de e-mailserver.
@mailserver_type is sysname, zonder standaardinstelling. Er wordt alleen een waarde ondersteund SMTP .
[ @port = ] port_number
Het nieuwe poortnummer van de e-mailserver. @port is int, zonder standaardwaarde.
[ @timeout = ] 'time-out'
Time-outparameter voor SmtpClient.Send één e-mailbericht.
@timeout in seconden is, zonder standaardwaarde.
[ @username = ] 'gebruikersnaam'
De nieuwe gebruikersnaam die moet worden gebruikt om u aan te melden bij de e-mailserver. @username is sysname, zonder standaardinstelling.
[ @password = ] 'wachtwoord'
Het nieuwe wachtwoord dat moet worden gebruikt om u aan te melden bij de e-mailserver. @password is sysname, zonder standaardinstelling.
[ @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-service.
@use_default_credentials is bit, zonder standaardinstelling. Wanneer deze parameter 1 is, gebruikt Database Mail de referenties van de database-engine. Wanneer deze parameter 0 is, gebruikt Database Mail de @username en @password voor verificatie op de SMTP-server. Als @username en @password zijn NULL, wordt anonieme verificatie gebruikt. Neem contact op met uw SMTP-beheerder voordat u deze parameter opgeeft
[ @enable_ssl = ] enable_ssl
Hiermee geeft u op of Database Mail communicatie versleutelt met TLS (Transport Layer Security), voorheen bekend als SSL (Secure Sockets Layer). Gebruik deze optie als TLS is vereist op uw SMTP-server. @enable_ssl is bit, zonder standaardinstelling.
Codewaarden retourneren
0 (geslaagd) of 1 (mislukt).
Opmerkingen
Wanneer zowel de accountnaam als de account-id zijn opgegeven, verandert de opgeslagen procedure de accountnaam naast het bijwerken van de gegevens voor het account. Het wijzigen van de accountnaam is handig om fouten in de accountnaam te corrigeren.
De opgeslagen procedure sysmail_update_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
Eén. De gegevens voor een account wijzigen
In het volgende voorbeeld wordt het account AdventureWorks Administrator in de msdb database bijgewerkt. De informatie voor het account is ingesteld op de opgegeven waarden.
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. De naam van een account en de gegevens voor een account wijzigen
In het volgende voorbeeld wordt de naam gewijzigd en worden de accountgegevens voor de account-id 125bijgewerkt. De nieuwe naam van het account is 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;