• Artikel

sysmail_configure_sp (Transact-SQL)

Ä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 unternimmt

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 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' ;