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 기본값NULL인 int입니다. @account_id 또는 @account_name 중 하나 이상을 지정해야 합니다. 둘 다 지정할 경우 프로시저가 계정 이름을 변경합니다.
[ @account_name = ] 'account_name'
업데이트할 계정의 이름입니다. @account_name sysname이며 기본값은 .입니다NULL. @account_id 또는 @account_name 중 하나 이상을 지정해야 합니다. 둘 다 지정할 경우 프로시저가 계정 이름을 변경합니다.
[ @email_address = ] 'email_address'
메시지를 보낼 새 전자 메일 주소입니다. 이 주소는 인터넷 전자 메일 주소여야 합니다. 주소의 서버 이름은 데이터베이스 메일 이 계정에서 메일을 보내는 데 사용하는 서버입니다. @email_address 기본값NULL인 nvarchar(128)입니다.
[ @display_name = ] 'display_name'
이 계정의 전자 메일 메시지에 사용할 새 표시 이름입니다. @display_name nvarchar(128)이며 기본값은 없습니다.
[ @replyto_address = ] 'replyto_address'
이 계정에서 보내는 전자 메일 메시지의 회신 머리글에 사용할 새 주소입니다. @replyto_address nvarchar(128)이며 기본값은 없습니다.
[ @description = ] 'description'
계정에 대한 새 설명입니다. @description 기본값NULL인 nvarchar(256)입니다.
[ @mailserver_name = ] 'server_name'
이 계정에 사용할 SMTP 메일 서버의 새 이름입니다. SQL Server를 실행하는 컴퓨터는 IP 주소에 대한 @mailserver_name 확인할 수 있어야 합니다. @mailserver_name 기본값이 없는 sysname입니다.
[ @mailserver_type = ] 'server_type'
메일 서버의 새 형식입니다. @mailserver_type 기본값이 없는 sysname입니다. 값 SMTP 만 지원됩니다.
[ @port = ] port_number
메일 서버의 새 포트 번호입니다. @port 기본값이 없는 int입니다.
[ @timeout = ] 'timeout'
단일 전자 메일 메시지의 시간 제한 매개 변수 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
데이터베이스 메일 이전에 SSL(Secure Sockets Layer)으로 알려진 TLS(전송 계층 보안)를 사용하여 통신을 암호화할지 여부를 지정합니다. SMTP 서버에서 TLS가 필요한 경우 이 옵션을 사용합니다. @enable_ssl 비트이며 기본값은 없습니다.
반환 코드 값
0(성공) 또는 1(실패).
설명
계정 이름과 계정 ID를 모두 지정하면 저장 프로시저는 계정 정보를 업데이트하는 것 외에도 계정 이름을 변경합니다. 계정 이름을 변경하면 계정 이름의 오류를 수정하는 데 유용합니다.
저장 프로시저 sysmail_update_account_sp 는 데이터베이스에 msdb 있으며 스키마가 소유합니다 dbo . 현재 데이터베이스가 아닌 msdb경우 프로시저를 세 부분으로 된 이름으로 실행해야 합니다.
사용 권한
이 절차에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.
예제
A. 계정에 대한 정보 변경
다음 예제에서는 데이터베이스에서 msdb 계정을 AdventureWorks Administrator 업데이트합니다. 계정에 대한 정보는 제공된 값으로 설정됩니다.
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;