共用方式為

sysmail_help_account_sp (Transact-SQL)

  • 發行項

適用於：SQL Server

列出 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) 如果電子郵件伺服器使用驗證，則用來登入電子郵件伺服器的用戶名稱。 當 為 NULL 時 username ，Database Mail 不會針對此帳戶使用驗證。
use_default_credentials bit 指定是否使用 SQL Server 資料庫引擎 的認證，將郵件傳送至 SMTP 伺服器。 當此參數為 1時，Database Mail 會使用 SQL Server 資料庫引擎 服務的認證。 當此參數為 0時，Database Mail 會 使用 @username 和 @password 在 SMTP 伺服器上進行驗證。 如果 @username 和 @password 為 NULL，則 Database Mail 會使用匿名驗證。 指定此參數之前，請先洽詢 SMTP 系統管理員。
enable_ssl bit 指定 Database Mail 是否使用傳輸層安全性 （TLS） 加密通訊，先前稱為安全套接字層 （SSL）。 如果您的 SMTP 伺服器上需要 TLS，請使用此選項。 1 表示 Database Mail 會使用 TLS 加密通訊。 0 表示 Database Mail 傳送郵件時沒有 TLS 加密。

備註

如果未提供任何account_id或account_name，sysmail_help_account請列出 Microsoft sql Server 實例中所有 Database Mail 帳戶的相關信息。

預存程式 sysmail_help_account_sp 位於 msdb 資料庫中，且由 dbo 架構所擁有。 如果目前的資料庫不是 msdb，則必須使用三部分名稱執行程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

A. 列出所有帳戶的資訊

下列範例顯示列出 實例中所有帳戶的帳戶資訊。

EXEC 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之帳戶的帳戶資訊。

EXEC 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

相關內容