共用方式為

  • 發行項

sysmail_configure_sp (Transact-SQL)

變更 Database Mail 的組態設定。sysmail_configure_sp 所指定的組態設定適用於整個 SQL Server 執行個體。

主題連結圖示Transact-SQL 語法慣例

語法

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

引數

  • [@parameter_name = ] 'parameter_name'
    要變更的參數名稱。

  • [@parameter_value = ] 'parameter_value'
    參數的新值。

  • [@description = ] 'description'
    參數的描述。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

無

備註

Database Mail 使用下列參數：

參數名稱

描述

預設值

AccountRetryAttempts

外部郵件處理序嘗試利用指定設定檔中的每個帳戶來傳送電子郵件訊息的次數。

1

AccountRetryDelay

在各次嘗試傳送訊息之間，外部郵件處理序所等待的時間 (以秒為單位)。

5000

DatabaseMailExeMinimumLifeTime

外部郵件處理序維持使用中的最短時間 (以秒為單位)。當 Database Mail 傳送許多訊息時，請增加這個值，使 Database Mail 保持在使用中，以避免頻繁的啟動和停止所帶來的負擔。

600

DefaultAttachmentEncoding

電子郵件附件的預設編碼。

MIME

MaxFileSize

附件的大小上限 (以位元組為單位)。

1000000

ProhibitedExtensions

無法作為電子郵件訊息附件來傳送的副檔名清單 (以逗號分隔)。

exe,dll,vbs,js

LoggingLevel

指定哪些訊息要記錄在 Database Mail 記錄中。可能的值為 1、2 或 3。

  • 1 - 這是標準模式。只記錄錯誤。

  • 2 - 這是擴充模式。記錄錯誤、警告和參考訊息。

  • 3 - 這是詳細資訊模式。記錄錯誤、警告、參考訊息、成功訊息和其他內部訊息。進行疑難排解時，請使用此模式。

2

預存程序 sysmail_configure_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。如果目前的資料庫不是 msdb，就必須利用三部分名稱來執行這個程序。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 將 Database Mail 設為每個帳戶重試 10 次

下列範例會顯示如何將 Database Mail 設為每個帳戶重試 10 次，之後，便認定無法連上這個帳戶。

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

B. 將附件大小上限設為 2 MB

下列範例會顯示如何將附件大小上限設為 2 MB。

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