sysmail_help_account_sp (Transact-SQL)

データベース メール アカウントに関する、パスワード以外の情報を一覧表示します。

トピック リンク アイコンTransact-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 サーバーに送信するかどうかを指定します。use_default_credentials のデータ型は bit で、既定値は 0 です。このパラメーターが 1 の場合、データベース メールでは、SQL Server データベース エンジン サービスの資格情報が使用されます。このパラメーターが 0 の場合、データベース メールでは、SMTP サーバーでの認証に @username および @password が使用されます。@username および @password が NULL の場合、データベース メールでは、匿名認証が使用されます。このパラメーターを指定する前に、SMTP 管理者に問い合わせてください。

enable_ssl

bit

データベース メールで SSL (Secure Sockets Layer) を使用して通信を暗号化するかどうかを指定します。SMTP サーバーで SSL が必要な場合はこのオプションを使用します。enable_ssl のデータ型は bit で、既定値はありません。1 の場合、データベース メールでは SSL を使用して通信を暗号化することを示します。0 の場合、データベース メールでは SSL 暗号化を使用せずにメールを送信することを示します。

説明

account_id または account_name を指定しない場合、sysmail_help_account では、Microsoft SQL Server インスタンスのすべてのデータベース メール アカウントに関する情報が一覧表示されます。

ストアド プロシージャ sysmail_help_account_spmsdb データベースにあり、dbo スキーマが所有しています。現在のデータベースが msdb でない場合、このプロシージャを実行するときには名前に 3 つの要素を指定する必要があります。

権限

このプロシージャの実行権限は、既定では 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