共用方式為

  • 發行項

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         AdventureWorks2008R2 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 = 'AdventureWorks2008R2 Administrator' ;

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

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