sysmail_help_account_sp (Transact-SQL)

列出 Database Mail 帳戶的相關資訊 (密碼除外)。

Transact-SQL 語法慣例

語法

sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]

引數

• [ @account_id = ] account_id
  這是要列出資訊之帳戶的帳戶識別碼。 account_id 是 int，預設值是 NULL。

• [ @account_name = ] 'account_name'
  要列出資訊的帳戶名稱。 account_name 是 sysname，預設值是 NULL。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

傳回包含下列資料行的結果集。

資料行名稱	資料類型	說明
account_id	int	帳戶的識別碼。
name	sysname	帳戶的名稱。
description	nvarchar(256)	帳戶的描述。
email_address	nvarchar(128)	傳送訊息的來源電子郵件地址。
display_name	nvarchar(128)	帳戶的顯示名稱。
replyto_address	nvarchar(128)	這個帳戶發出的訊息之回應所要送往的地址。
servertype	sysname	帳戶的電子郵件伺服器類型。
servername	sysname	帳戶的電子郵件伺服器名稱。
port	int	電子郵件伺服器所用的通訊埠編號。
username	nvarchar(128)	如果電子郵件伺服器使用驗證的話，用來登入電子郵件伺服器的使用者名稱。 當 username 是 NULL 時，Database Mail 不會在這個帳戶上使用驗證。
use_default_credentials	bit	指定是否要使用 SQL Server Database Engine 的認證將郵件傳送至 SMTP 伺服器。 use_default_credentials 是 bit，沒有預設值。 當此參數是 1 時，Database Mail 會使用 SQL Server Database Engine 服務的認證。 當此參數是 0 時，Database Mail 會使用 @username 和 @password 在 SMTP 伺服器上進行驗證。 如果 @username 和 @password 是 NULL，則 Database Mail 會使用匿名驗證。 在指定此參數之前，請洽詢 SMTP 管理員。
enable_ssl	bit	指定 Database Mail 是否使用安全通訊端層 (SSL) 加密通訊。 如果 SMTP 伺服器上需要 SSL，則使用此選項。 enable_ssl 是 bit，沒有預設值。 1 表示 Database Mail 會使用 SSL 加密通訊。 0 表示 Database Mail 傳送郵件時不使用 SSL 加密。

備註

若未提供 account_id 或 account_name，sysmail_help_account 會列出 Microsoft SQL Server 執行個體中之所有 Database Mail 帳戶的相關資訊。

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

權限

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

範例

A. 列出所有帳戶的資訊

下列範例會顯示如何列出執行個體中之所有帳戶的帳戶資訊。

EXECUTE msdb.dbo.sysmail_help_account_sp ;

範例結果集如下 (行的長度經過編輯)：

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      
149         Audit Account                Account for audit e-mail.               audit@Adventure-Works.com Automated Mailer (Audit)         NULL            SMTP       smtp.Adventure-Works.com  25          NULL 0                          0      

B. 列出特定帳戶的資訊

下列範例會顯示如何列出名稱為 AdventureWorks Administrator 之帳戶的帳戶資訊。

EXECUTE msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks Administrator' ;

範例結果集如下 (行的長度經過編輯)：

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0     

請參閱

參考

Database Mail 預存程序 (Transact-SQL)

概念

Database Mail

建立 Database Mail 帳戶