共用方式為


sysmail_help_configure_sp (Transact-SQL)

顯示 Database Mail 的組態設定。

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

語法

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_spmsdb 資料庫中,擁有者是 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