sysmail_update_account_sp (Transact-SQL)
適用対象:
SQL Server
既存のデータベース メール アカウントの情報を変更します。
構文
sysmail_update_account_sp [ [ @account_id = ] account_id ] [ , ] [ [ @account_name = ] 'account_name' ]
, [ @email_address = ] 'email_address'
, [ @display_name = ] 'display_name'
, [ @replyto_address = ] 'replyto_address'
, [ @description = ] 'description'
, [ @mailserver_name = ] 'server_name'
, [ @mailserver_type = ] 'server_type'
, [ @port = ] port_number
, [ @timeout = ] 'timeout'
, [ @username = ] 'username'
, [ @password = ] 'password'
, [ @use_default_credentials = ] use_default_credentials
, [ @enable_ssl = ] enable_ssl
[ ; ]
引数
[ @account_id = ] account_id
更新するアカウント ID。 @account_idは int で、既定値は NULL. 少なくとも 1 つの @account_id または @account_nameを 指定する必要があります。 両方を指定すると、プロシージャによってアカウントの名前が変更されます。
[ @account_name = ] 'account_name'
更新するアカウントの名前。 @account_nameは sysname で、既定値は NULL. 少なくとも 1 つの @account_id または @account_nameを 指定する必要があります。 両方を指定すると、プロシージャによってアカウントの名前が変更されます。
[ @email_address = ] 'email_address'
メッセージの送信先となる新しい電子メール アドレス。 このアドレスは、インターネットの電子メール アドレスである必要があります。 アドレス内のサーバー名は、このアカウントからメールを送信するために使用データベース メールサーバーです。 @email_addressは nvarchar(128) で、既定値は NULL.
[ @display_name = ] 'display_name'
このアカウントから送信する電子メール メッセージの新しい表示名を指定します。 @display_nameは nvarchar(128) で、既定値はありません。
[ @replyto_address = ] 'replyto_address'
このアカウントから送信する電子メール メッセージの [返信先] ヘッダーで使用する新しいアドレスを指定します。 @replyto_addressは nvarchar(128)で、既定値はありません。
[ @description = ] 'description'
アカウントの新しい説明。 @descriptionは nvarchar(256) で、既定値は NULL.
[ @mailserver_name = ] 'server_name'
このアカウントに使用する SMTP メール サーバーの新しい名前。 SQL Server を実行するコンピューターは、@mailserver_nameを IP アドレスに解決できる必要があります。 @mailserver_nameは sysname で、既定値はありません。
[ @mailserver_type = ] 'server_type'
メール サーバーの新しい種類を指定します。 @mailserver_typeは sysname で、既定値はありません。 値 SMTP のみがサポートされています。
[ @port = ] port_number
メール サーバーの新しいポート番号。 @portは int で、既定値はありません。
[ @timeout = ] 'timeout'
1 つの電子メール メッセージのタイムアウト パラメーター SmtpClient.Send 。 @timeoutは秒単位で、既定値はありません。
[ @username = ] 'username'
メール サーバーへのログオンに使用する新しいユーザー名。 @usernameは sysname で、既定値はありません。
[ @password = ] 'password'
メール サーバーへのログオンに使用する新しいパスワード。 @passwordは sysname で、既定値はありません。
[ @use_default_credentials = ] use_default_credentials
SQL Server データベース エンジン サービスの資格情報を使用して SMTP サーバーにメールを送信するかどうかを指定します。 @use_default_credentialsはビットであり、既定値はありません。 このパラメーターが 1 の場合、データベース メールはデータベース エンジンの資格情報を使用します。 このパラメーターが 0 の場合、データベース メールは SMTP サーバーでの認証に@usernameと@passwordを使用します。 @usernameと@passwordがある場合はNULL、匿名認証を使用します。 このパラメーターを指定する前に、SMTP 管理者に問い合わせてください
[ @enable_ssl = ] enable_ssl
データベース メールトランスポート層セキュリティ (TLS) (以前は Secure Sockets Layer (SSL) と呼ばれる) を使用して通信を暗号化するかどうかを指定します。 SMTP サーバーで TLS が必要な場合は、このオプションを使用します。 @enable_sslはビットであり、既定値はありません。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
アカウント名とアカウント ID の両方を指定すると、ストアド プロシージャはアカウントの情報を更新するだけでなく、アカウント名を変更します。 アカウント名を変更すると、アカウント名のエラーを修正するのに役立ちます。
ストアド プロシージャ sysmail_update_account_sp はデータベース内にあり msdb 、スキーマによって dbo 所有されています。 現在のデータベースが実行されていない msdb場合は、プロシージャを 3 部構成の名前で実行する必要があります。
アクセス許可
このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
A. アカウントの情報を変更する
次の例では、データベース内のアカウント AdventureWorks Administrator を msdb 更新します。 アカウントの情報は、指定された値に設定されます。
EXEC msdb.dbo.sysmail_update_account_sp
@account_name = 'AdventureWorks Administrator',
@description = 'Mail account for administrative e-mail.',
@email_address = 'dba@adventure-works.com',
@display_name = 'AdventureWorks Automated Mailer',
@replyto_address = NULL,
@mailserver_name = 'smtp.adventure-works.com',
@mailserver_type = 'SMTP',
@port = 25,
@timeout = 60,
@username = NULL,
@password = NULL,
@use_default_credentials = 0,
@enable_ssl = 0;
B. アカウントの名前とアカウントの情報を変更する
次の例では、名前を変更し、アカウント ID 125を持つアカウント情報を更新します。 アカウントの新しい名前は Backup Mail Server.
EXEC msdb.dbo.sysmail_update_account_sp
@account_id = 125,
@account_name = 'Backup Mail Server',
@description = 'Mail account for administrative e-mail.',
@email_address = 'dba@adventure-works.com',
@display_name = 'AdventureWorks Automated Mailer',
@replyto_address = NULL,
@mailserver_name = 'smtp-backup.adventure-works.com',
@mailserver_type = 'SMTP',
@port = 25,
@timeout = 60,
@username = NULL,
@password = NULL,
@use_default_credentials = 0,
@enable_ssl = 0;
関連するコンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示