sysmail_configure_sp (Transact-SQL)

Artikel
06/18/2013

Ändert Konfigurationseinstellungen für Datenbank-E-Mail. Die mit sysmail_configure_sp angegebenen Konfigurationseinstellungen gelten für die ganze SQL Server-Instanz.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
    [ , [ @parameter_value = ] 'parameter_value' ]
    [ , [ @description = ] 'description' ]

Argumente

[@parameter_name = ] 'parameter_name'
Der Name des Parameters, der geändert werden soll
[@parameter_value = ] 'parameter_value'
Der neue Wert des Parameters
[@description = ] 'description'
Eine Beschreibung des Parameters

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Datenbank-E-Mail verwendet die folgenden Parameter:

Parametername	Beschreibung	Standardwert
AccountRetryAttempts	Gibt an, wie oft der externe E-Mail-Prozess versucht, die E-Mail-Nachricht zu senden, wobei jedes Konto im angegebenen Profil verwendet wird.	1
AccountRetryDelay	Gibt an, wie lange (in Sekunden) der externe E-Mail-Prozess zwischen zwei Versuchen, eine Nachricht zu senden, warten soll.	5000
DatabaseMailExeMinimumLifeTime	Gibt an, wie lange (in Sekunden) der externe E-Mail-Prozess mindestens aktiv bleibt. Wenn Datenbank-E-Mail viele Nachrichten sendet, sollten Sie diesen Wert erhöhen, damit Datenbank-E-Mail aktiv bleibt und unnötiger Aufwand durch häufiges Starten und Beenden vermieden wird.	600
DefaultAttachmentEncoding	Die Standardcodierung für E-Mail-Anlagen	MIME
MaxFileSize	Die maximale Größe einer Anlage in Bytes	1000000
ProhibitedExtensions	Eine durch Trennzeichen getrennte Liste mit Erweiterungen, die nicht als Anlagen einer E-Mail-Nachricht gesendet werden können.	exe,dll,vbs,js
LoggingLevel	Geben Sie an, welche Nachrichten in der Protokolldatei von Datenbank-E-Mail aufgezeichnet werden. Mögliche Werte sind 1, 2 und 3. 1 - Dies ist der normale Modus. Es werden nur Fehler protokolliert. 2 - Dies ist der erweiterte Modus. Es werden Fehler-, Warn- und Informationsmeldungen protokolliert. 3 - Dies ist der ausführliche Modus. Es werden Fehler-, Warn-, Informations-, Erfolgs- sowie zusätzliche interne Meldungen protokolliert. Verwenden Sie diesen Modus zur Problembehandlung.	2

Die gespeicherte Prozedur sysmail_configure_sp befindet sich in der msdb-Datenbank. Der Besitzer ist das dbo-Schema. Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um die msdb-Datenbank handelt.

Berechtigungen

Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über Berechtigungen zum Ausführen dieser Prozedur.

Beispiele

A. Festlegen, dass Datenbank-E-Mail für jedes Konto 10 Wiederholungsversuche ausführt

Im folgenden Beispiel wird gezeigt, wie Datenbank-E-Mail so konfiguriert wird, dass für jedes Konto 10 Wiederholungsversuche unternommen werden, bevor das jeweilige Konto als nicht erreichbar eingestuft wird.

EXECUTE msdb.dbo.sysmail_configure_sp
    'AccountRetryAttempts', '10' ;

B. Festlegen der maximalen Anlagengröße auf zwei Megabyte

Im folgenden Beispiel wird gezeigt, wie die maximale Anlagengröße auf 2 MB festgelegt wird.

EXECUTE msdb.dbo.sysmail_configure_sp
    'MaxFileSize', '2097152' ;

Siehe auch

Verweis

sysmail_help_configure_sp (Transact-SQL)

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

Konzepte

Datenbank-E-Mail

Freigeben über