sysmail_help_account_sp (Transact-SQL)
適用於：
SQL Server
列出 Database Mail 帳戶的相關信息（密碼除外）。
語法
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，則必須使用三部分名稱執行程式。
權限
您可以授與此 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