sysmail_configure_sp (Transact-SQL)

Van toepassing op:SQL Server

Hiermee wijzigt u de configuratie-instellingen voor Database Mail. De gespecificeerde configuratie-instellingen gelden sysmail_configure_sp voor de gehele SQL Server-instantie.

Transact-SQL syntaxis-conventies

Syntax

dbo.sysmail_configure_sp
    [ @parameter_name = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
    [ , [ @description = ] N'description' ]
[ ; ]

Arguments

[ @parameter_name = ] N'parameter_name'

De naam van de parameter die te veranderen is.

[ @parameter_value = ] N'parameter_value'

De nieuwe waarde van de parameter.

[ @description = ] Beschrijving van'

Een beschrijving van de parameter.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

None.

Remarks

Database Mail gebruikt de volgende parameters:

Parameternaam Description Standaardwaarde
AccountRetryAttempts Het aantal keren dat het externe e-mailproces het e-mailbericht probeert te verzenden met elk account in het opgegeven profiel. 1
AccountRetryDelay De tijd, in seconden, voor het externe mailproces om te wachten tussen pogingen om een bericht te versturen. 5000
DatabaseMailExeMinimumLifeTime De minimale tijdsduur, in seconden, dat het externe e-mailproces actief blijft. Wanneer Database Mail veel berichten verzendt, verhoog dan deze waarde om Database Mail actief te houden en de overhead van frequente starts en stops te vermijden. 600
DefaultAttachmentEncoding De standaardcodering voor e-mailbijlagen. MIME
MaxFileSize De maximale grootte van een bijlage, in bytes. 1000000
ProhibitedExtensions Een door komma's gescheiden lijst met extensies die niet als bijlage kunnen worden verzonden naar een e-mailbericht. exe,dll,vbs,js
LoggingLevel Geef op welke berichten worden vastgelegd in het database-e-maillogboek. Een van de volgende numerieke waarden:

1 - Dit is normale modus. Logs alleen fouten.

2 - Dit is uitgebreide modus. Logt fouten, waarschuwingen en informatieve berichten.

3 - Dit is de verbose modus. Logt fouten, waarschuwingen, informatieve berichten, succesberichten en extra interne berichten. Gebruik deze modus voor probleemoplossing.
2

De opgeslagen procedure sysmail_configure_sp bevindt zich in de msdb database en is eigendom van het dbo schema. De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.

Permissions

Vereist CONTROL SERVER toestemming op de server of lidmaatschap van de db_owner databaserol in de msdb database.

Je kunt ook rechten verlenen EXECUTE aan elke gebruiker, waardoor de gebruiker deze procedure kan gebruiken om de configuratie te lezen, maar geen parameters te wijzigen. Deze extra rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Examples

A. Stel Database Mail in om elk account tien keer opnieuw te proberen

Het volgende voorbeeld laat zien dat je Database Mail zo instelt dat je elk account 10 keer opnieuw probeert voordat het account als onbereikbaar wordt beschouwd.

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

B. Stel de maximale bijlagegrootte in op 2 megabytes

Het volgende voorbeeld toont het instellen van de maximale bijlagegrootte op 2 megabyte.

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