sysmail_update_account_sp(Transact-SQL)

적용 대상:SQL Server

기존 데이터베이스 메일 계정의 정보를 변경합니다.

Transact-SQL 구문 표기 규칙

구문

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경우 프로시저를 세 부분으로 된 이름으로 실행해야 합니다.

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 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;

관련 콘텐츠

• 데이터베이스 메일
• 데이터베이스 메일 계정 만들기
• 저장 프로시저 데이터베이스 메일(Transact-SQL)