sysmail_configure_sp (Transact-SQL)

  • Artikel

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 (Erfolg) 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 von Erweiterungen, die nicht als Anlage an eine 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 befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch 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.

EXEC 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.

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

Zugehöriger Inhalt