sysmail_configure_sp (Transact-SQL)
Gilt für: 
SQL Server
Ändert Konfigurationseinstellungen für Datenbank-E-Mail. Die konfigurationseinstellungen, die für sysmail_configure_sp die gesamte SQL Server-Instanz angegeben sind.
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 (erfolgreich) oder 1 Fehler.
Resultset
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 |
Gibt an, welche Nachrichten im Datenbank-E-Mail-Protokoll aufgezeichnet werden. Einer der folgenden numerischen Werte: 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 und gehört dem dbo Schema. Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.
Berechtigungen
Erfordert CONTROL SERVER berechtigungen für den Server oder die Mitgliedschaft in der db_owner Datenbankrolle in der msdb Datenbank.
Sie können auch Berechtigungen für jeden Benutzer erteilen EXECUTE , der es dem Benutzer ermöglicht, diese Konfiguration zu lesen, aber keine Parameter zu ändern. Diese hinzugefügten Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.
Beispiele
A. Festlegen Datenbank-E-Mail, dass jedes Konto 10 Mal erneut versucht wird
Das folgende Beispiel zeigt, dass Datenbank-E-Mail jedes Konto 10 Mal erneut versuchen soll, bevor es berücksichtigt wird, dass das Konto nicht erreichbar ist.
EXECUTE msdb.dbo.sysmail_configure_sp 'AccountRetryAttempts', '10';
B. Festlegen der maximalen Anlagengröße auf 2 MB
Im folgenden Beispiel wird gezeigt, wie die maximale Anlagengröße auf 2 MB festgelegt wird.
EXECUTE msdb.dbo.sysmail_configure_sp 'MaxFileSize', '2097152';