sysmail_help_configure_sp (Transact-SQL)
顯示 Database Mail 的組態設定。
.gif "主題連結圖示")
語法
sysmail_help_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
引數
- [@parameter_name = ] 'parameter_name'
要擷取之組態設定的名稱。當指定這個引數時，會在 @parameter_value OUTPUT 參數中傳回組態設定值。當未指定 @parameter_name 時，這個預存程序會傳回包含執行個體中之所有 Database Mail 組態設定的結果集。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
當未指定 @parameter_name 時，會傳回含下列資料行的結果集。
資料行名稱 |
資料類型 |
描述 |
paramname |
nvarchar(256) |
組態參數的名稱。 |
paramvalue |
nvarchar(256) |
組態參數值。 |
description |
nvarchar(256) |
組態參數的描述。 |
備註
sysmail_help_configure_sp 預存程序會列出執行個體目前的 Database Mail 組態設定。
當指定了 @parameter_name，但並未提供 @parameter_value 的輸出參數時，這個預存程序不會產生任何輸出。
預存程序 sysmail_help_configure_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。如果目前的資料庫不是 msdb，就必須利用三部分名稱來叫用這個程序。
權限
這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會顯示如何列出 SQL Server 執行個體的 Database Mail 組態設定。
EXECUTE msdb.dbo.sysmail_help_configure_sp ;
範例結果集如下 (行的長度經過編輯)：
paramname paramvalue description
------------------------------- --------------- -----------------------------------------------------------------------------
AccountRetryAttempts 1 Number of retry attempts for a mail server
AccountRetryDelay 5000 Delay between each retry attempt to mail server
DatabaseMailExeMinimumLifeTime 600 Minimum process lifetime in seconds
DefaultAttachmentEncoding MIME Default attachment encoding
LoggingLevel 2 Database Mail logging level: normal - 1, extended - 2 (default), verbose - 3
MaxFileSize 1000000 Default maximum file size
ProhibitedExtensions exe,dll,vbs,js Extensions not allowed in outgoing mails
請參閱
參考
Database Mail 和 SQL Mail 預存程序 (Transact-SQL)
其他資源
Database Mail
選取組態工作 (Database Mail)