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.
Conventions 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.
|
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 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 montre la manière de configurer la messagerie de base de données pour qu'elle tente de se connecter à chaque compte à 10
reprises avant de considérer le compte comme étant injoignable.
EXECUTE msdb.dbo.sysmail_configure_sp
'AccountRetryAttempts', '10' ;
B. Définition de la taille maximale des pièces jointes à 2 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' ;
Voir aussi
Référence
sysmail_help_configure_sp (Transact-SQL)
Procédures stockées de messagerie de base de données et SQL Mail (Transact-SQL)
Autres ressources
Messagerie de base de données
Dépannage de la messagerie de base de données