sysmail_configure_sp (Transact-SQL)
適用於：
SQL Server
變更 Database Mail 的組態設定。 指定的 sysmail_configure_sp 組態設定會套用至整個 SQL Server 實例。
語法
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 - 這是詳細資訊模式。 記錄錯誤、警告、資訊訊息、成功訊息和其他內部訊息。 使用此模式進行疑難解答。 |
2 |
預存程式 sysmail_configure_sp 位於 msdb 資料庫中，而且是由 dbo 架構所擁有。 如果目前的資料庫不是 msdb，則必須使用三部分名稱執行程式。
權限
CONTROL SERVER需要伺服器的許可權，或資料庫中db_owner資料庫角色msdb的成員資格。
您也可以授與 EXECUTE 任何使用者的許可權，讓用戶能夠使用此程式來讀取設定，但不要變更任何參數。 這些新增的許可權可能會在 SQL Server 升級期間覆寫。
範例
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';