sysmail_help_account_sp (Transact-SQL)
適用対象: 
SQL サーバー
データベース メール アカウントに関する、パスワード以外の情報を一覧表示します。
構文
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
[ ; ]
引数
[ @account_id = ] account_id
情報を一覧表示するアカウントのアカウント ID。 @account_id は int で、既定値は NULL です。
[ @account_name = ] 'account_name'
情報を一覧表示するアカウントの名前を指定します。 @account_name は sysname で、既定値は NULL です。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
次に示す列を含む結果セットを返します。
| 列名 | データ型 | 説明 |
|---|---|---|
account_id |
int | アカウントの ID。 |
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 の場合、データベース メールはこのアカウントの認証を使用しません。 |
use_default_credentials |
bit | SQL Server データベース エンジンの資格情報を使用して SMTP サーバーにメールを送信するかどうかを指定します。 このパラメーターを1すると、データベース メールは SQL Server データベース エンジン サービスの資格情報を使用します。 このパラメーターを0すると、データベース メールは SMTP サーバーでの認証に@usernameと@passwordを使用します。 @usernameと@passwordが NULL の場合、データベース メールは匿名認証を使用します。 このパラメーターを指定する前に、SMTP 管理者に問い合わせてください。 |
enable_ssl |
bit | データベース メールトランスポート層セキュリティ (TLS) (以前は Secure Sockets Layer (SSL) と呼ばれる) を使用して通信を暗号化するかどうかを指定します。 SMTP サーバーで TLS が必要な場合は、このオプションを使用します。 1は、TLS を使用して通信データベース メール暗号化を示します。 0 は、TLS 暗号化なしでメールを送信データベース メールを示します。 |
解説
account_idまたはaccount_nameが指定されていない場合、sysmail_help_accountは Microsoft SQL Server インスタンス内のすべてのデータベース メール アカウントに関する情報を一覧表示します。
ストアド プロシージャ sysmail_help_account_sp は msdb データベースにあり、 dbo スキーマによって所有されます。 現在のデータベースが msdbされていない場合は、プロシージャを 3 部構成の名前で実行する必要があります。
アクセス許可
このストアド プロシージャは、 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