sysmail_update_account_sp (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mengubah informasi di akun Email Database yang sudah ada.

Konvensi sintaks transact-SQL

Sintaks

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
[ ; ]

Argumen

[ @account_id = ] account_id

ID akun yang akan diperbarui. @account_id int, dengan default NULL. Setidaknya salah satu @account_id atau @account_name harus ditentukan. Jika keduanya ditentukan, prosedur akan mengubah nama akun.

[ @account_name = ] 'account_name'

Nama akun yang akan diperbarui. @account_name adalah sysname, dengan default NULL. Setidaknya salah satu @account_id atau @account_name harus ditentukan. Jika keduanya ditentukan, prosedur akan mengubah nama akun.

[ @email_address = ] 'email_address'

Alamat email baru untuk mengirim pesan. Alamat ini harus berupa alamat email internet. Nama server di alamat adalah server yang digunakan Database Mail untuk mengirim email dari akun ini. @email_address adalah nvarchar(128), dengan default NULL.

[ @display_name = ] 'display_name'

Nama tampilan baru yang akan digunakan pada pesan email dari akun ini. @display_name adalah nvarchar(128), tanpa default.

[ @replyto_address = ] 'replyto_address'

Alamat baru yang akan digunakan di header Balas-Ke pesan email dari akun ini. @replyto_address adalah nvarchar(128), tanpa default.

[ @description = ] 'deskripsi'

Deskripsi baru untuk akun tersebut. @description adalah nvarchar(256), dengan default NULL.

[ @mailserver_name = ] 'server_name'

Nama baru server email SMTP yang akan digunakan untuk akun ini. Komputer yang menjalankan SQL Server harus dapat menyelesaikan @mailserver_name ke alamat IP. @mailserver_name adalah sysname, tanpa default.

[ @mailserver_type = ] 'server_type'

Tipe baru server email. @mailserver_type adalah sysname, tanpa default. Hanya nilai yang SMTP didukung.

[ @port = ] port_number

Nomor port baru server email. @port int, tanpa default.

[ @timeout = ] 'waktu habis'

Parameter batas waktu untuk SmtpClient.Send satu pesan email. @timeout dalam hitung detik, tanpa default.

[ @username = ] 'nama pengguna'

Nama pengguna baru yang digunakan untuk masuk ke server surat. @username adalah sysname, tanpa default.

[ @password = ] 'kata sandi'

Kata sandi baru yang digunakan untuk masuk ke server surat. @password adalah sysname, tanpa default.

[ @use_default_credentials = ] use_default_credentials

Menentukan apakah akan mengirim email ke server SMTP menggunakan kredensial layanan Mesin Database SQL Server. @use_default_credentials adalah bit, tanpa default. Saat parameter ini adalah 1, Database Mail menggunakan kredensial Mesin Database. Ketika parameter ini adalah 0, Database Mail menggunakan @username dan @password untuk autentikasi di server SMTP. Jika @username dan @password adalah NULL, maka menggunakan autentikasi anonim. Konsultasikan dengan administrator SMTP Anda sebelum menentukan parameter ini

[ @enable_ssl = ] enable_ssl

Menentukan apakah Database Mail mengenkripsi komunikasi menggunakan Transport Layer Security (TLS), yang sebelumnya dikenal sebagai Secure Sockets Layer (SSL). Gunakan opsi ini jika TLS diperlukan di server SMTP Anda. @enable_ssl adalah bit, tanpa default.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Ketika nama akun dan ID akun ditentukan, prosedur tersimpan mengubah nama akun selain memperbarui informasi untuk akun. Mengubah nama akun berguna untuk memperbaiki kesalahan dalam nama akun.

Prosedur sysmail_update_account_sp tersimpan ada di msdb database dan dimiliki oleh dbo skema. Prosedur harus dijalankan dengan nama tiga bagian jika database saat ini bukan msdb.

Izin

Prosedur tersimpan ini dimiliki oleh peran db_owner . Anda dapat memberikan EXECUTE izin untuk pengguna mana pun, tetapi izin ini dapat ditimpa selama peningkatan SQL Server.

Contoh

J. Mengubah informasi untuk akun

Contoh berikut memperbarui akun AdventureWorks Administrator Dalam msdb database. Informasi untuk akun diatur ke nilai yang disediakan.

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. Mengubah nama akun dan informasi untuk akun

Contoh berikut mengubah nama dan memperbarui informasi akun untuk dengan ID 125akun . Nama baru akun adalah 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;

Konten terkait