sysmail_update_account_sp (T-SQL)
Berlaku untuk: SQL Server
Mengubah informasi di akun Email Database yang sudah ada.
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 125
akun . 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk