sysmail_update_account_sp (Transact-SQL)

Artikel
06/18/2013

Ändert die Informationen in einem vorhandenen Konto für Datenbank-E-Mail.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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 , 
    [ @username = ] 'username' ,
    [ @password = ] 'password' ,
    [ @use_default_credentials = ] use_default_credentials ,
    [ @enable_ssl = ] enable_ssl

Argumente

[ @account_id = ] account_id
Die ID des Kontos, das aktualisiert werden soll. account_id ist vom Datentyp int. Der Standardwert ist NULL. Es muss mindestens account_id oder account_name angegeben werden (es können auch beide angegeben werden). Wenn beide Argumente angegeben werden, ändert die Prozedur den Namen des Kontos.
[ @account_name = ] 'account_name'
Der Name des zu aktualisierenden Kontos. account_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es muss mindestens account_id oder account_name angegeben werden (es können auch beide angegeben werden). Wenn beide Argumente angegeben werden, ändert die Prozedur den Namen des Kontos.
[ @email_address = ] 'email_address'
Die neue E-Mail-Adresse, von der die Nachricht gesendet werden soll. Bei dieser Adresse muss es sich um eine Internet-E-Mail-Adresse handeln. Der Servername ist die Adresse des Servers, der von Datenbank-E-Mail zum Senden von E-Mails von diesem Konto verwendet wird. email_address ist vom Datentyp nvarchar(128). Der Standardwert ist NULL.
[ @display_name = ] 'display_name'
Der neue Anzeigename, der in E-Mail-Nachrichten verwendet werden soll, die von diesem Konto gesendet werden. display_name ist vom Datentyp nvarchar(128) und hat keinen Standardwert.
[ @replyto_address = ] 'replyto_address'
Die neue Adresse, die im Antwortheader von E-Mail-Nachrichten verwendet werden soll, die von diesem Konto gesendet werden. replyto_address ist vom Datentyp nvarchar(128) und hat keinen Standardwert.
[ @description = ] 'description'
Die neue Beschreibung des Kontos. description ist vom Datentyp nvarchar(256). Der Standardwert ist NULL.
[ @mailserver_name = ] 'server_name'
Der neue Name des SMTP-Mailservers, der für dieses Konto verwendet werden soll. Der Computer, auf dem SQL Server ausgeführt wird, muss den server_name in eine IP-Adresse auflösen können. server_name ist vom Datentyp sysname und hat keinen Standardwert.
[ @mailserver_type = ] 'server_type'
Der neue Typ des E-Mail-Servers. server_type ist vom Datentyp sysname und hat keinen Standardwert. Für SQL Server 2005 und später wird nur der Wert 'SMTP' unterstützt.
[ @port = ] port_number
Die neue Portnummer des E-Mail-Servers. port_number ist vom Datentyp int und hat keinen Standardwert.
[ @username = ] 'username'
Der neue Benutzername, der für die Anmeldung beim E-Mail-Server verwendet werden soll. User name ist vom Datentyp sysname und hat keinen Standardwert.
[ @password = ] 'password'
Das neue Kennwort, das für die Anmeldung beim E-Mail-Server verwendet werden soll. password ist vom Datentyp sysname und hat keinen Standardwert.
[ @use_default_credentials = ] use_default_credentials
Gibt an, ob E-Mail mit den Anmeldeinformationen des SQL Server Database Engine (Datenbankmodul)-Diensts an den SMTP-Server gesendet werden soll. use_default_credentials ist vom Datentyp bit und hat keinen Standardwert. Wenn dieser Parameter 1 ist, verwendet Datenbank-E-Mail die Anmeldeinformationen von Database Engine (Datenbankmodul). Wenn dieser Parameter 0 ist, verwendet Datenbank-E-Mail die für die Authentifizierung beim SMTP-Server für @username und @password angegebenen Werte. Wenn @username und @password NULL sind, verwendet das Konto die anonyme Authentifizierung. Besprechen Sie die geeignete Angabe für diesen Parameter mit Ihrem SMTP-Administrator.
[ @enable_ssl = ] enable_ssl
Gibt an, ob Datenbank-E-Mail die Kommunikation mithilfe von SSL (Secure Sockets Layer) verschlüsseln soll. Verwenden Sie diese Option, wenn auf dem SMTP-Server SSL erforderlich ist. enable_ssl ist vom Datentyp bit und hat keinen Standardwert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Wenn sowohl Kontoname als auch Konto-ID angegeben wird, aktualisiert die gespeicherte Prozedur nicht nur die Informationen für das Konto, sondern ändert auch noch den Kontonamen. Die Änderung des Kontonamens kann hilfreich sein, wenn ein fehlerhafter Kontoname korrigiert werden soll.

Die gespeicherte Prozedur sysmail_update_account_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um die msdb-Datenbank handelt.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

A.Ändern der Informationen für ein Konto

Im folgenden Beispiel wird das Konto AdventureWorks Administrator in der msdb-Datenbank aktualisiert. Die Informationen für dieses Konto werden auf die bereitgestellten Werte festgelegt.

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
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

B.Ändern des Namens eines Kontos und der Informationen für ein Konto

Im folgenden Beispiel wird der Name des Kontos mit der Konto-ID 125 geändert, und die Informationen für dieses Konto werden aktualisiert. Der Name des Kontos lautet 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,
    ,@username = NULL
    ,@password = NULL
    ,@use_default_credentials = 0
    ,@enable_ssl = 0;

Siehe auch

Verweis

Gespeicherte Prozeduren für Datenbank-E-Mail (Transact-SQL)

Konzepte

Datenbank-E-Mail

Erstellen eines Kontos für Datenbank-E-Mail

Freigeben über