• Article

sysmail_configure_sp (Transact-SQL)

Modifie les paramètres de sécurité de la messagerie de base de données. Les paramètres de configuration spécifiés avec sysmail_configure_sp s'appliquent à la totalité de l'instance SQL Server.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [@parameter_name = ] 'parameter_name'
    Nom du paramètre à modifier.

  • [@parameter_value = ] 'parameter_value'
    Nouvelle valeur du paramètre.

  • [@description = ] 'description'
    Description du paramètre.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

La messagerie de base de données utilise les paramètres suivants :

Nom du paramètre

Description

Valeur par défaut

AccountRetryAttempts

Nombre de fois où le processus de messagerie externe tente d'envoyer le message électronique à l'aide de chaque compte présent dans le profil spécifié.

1

AccountRetryDelay

Quantité de temps, en secondes, d'attente du processus de messagerie externe entre chaque tentative d'envoi d'un message.

5000

DatabaseMailExeMinimumLifeTime

Quantité de temps minimale, en secondes, pendant laquelle le processus de messagerie externe reste actif. Lorsque la messagerie de base de données envoie un nombre important de messages, augmentez cette valeur afin de conserver cette messagerie de base de données active et d'éviter la charge de gestion engendrée par des démarrages et arrêts fréquents.

600

DefaultAttachmentEncoding

Codage par défaut pour les pièces jointes de messagerie électronique.

MIME

MaxFileSize

Taille de pièce jointe maximale, en octets.

1000000

ProhibitedExtensions

Liste d'extensions séparées par des virgules qui ne peuvent être envoyées sous forme de pièce jointe d'un message électronique.

exe,dll,vbs,js

LoggingLevel

Spécifie quels messages sont enregistrés dans le journal de la messagerie de base de données. Les valeurs possibles sont 1, 2 ou 3.

  • 1 - Mode normal. Seules les erreurs sont consignées dans le journal.

  • 2 - Mode étendu. Les erreurs, les avertissements et les messages à contenu informatif sont consignés dans le journal.

  • 3 - Mode documenté. Les erreurs, les avertissements, les messages informatifs et de réussite ainsi que d'autres messages internes sont consignés dans le journal. Utilisez ce mode lorsque vous tentez de résoudre des problèmes.

2

La procédure stockée sysmail_configure_sp se trouve dans la base de données msdb et appartient au schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données en cours n'est pas msdb.

Autorisations

Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemples

A. Paramétrage de la messagerie de base de données pour réessayer chaque compte 10 fois

L'exemple suivant illustre le paramétrage de la base de données de messagerie afin de réessayer chaque compte à dix reprises, avant de considérer que le compte est injoignable.

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

B. Paramétrage de la taille de pièce jointe maximale à deux mégaoctets

L'exemple suivant illustre le paramétrage de la taille de pièce jointe maximale à 2 mégaoctets.

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