Makale
07/26/2011

sysmail_add_account_sp (Transact-SQL)

Bir SMTP hesabı bilgilerini tutan yeni bir veritabanı posta hesabı oluşturur.

Konu bağlantısı simgesi Transact-SQL sözdizimi kuralları

Sözdizimi

sysmail_add_account_sp  [ @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 ]
    [ , [ @username = ] 'username' ]
    [ , [ @password = ] 'password' ]
    [ , [ @use_default_credentials = ] use_default_credentials ]
    [ , [ @enable_ssl = ] enable_ssl ]
    [ , [ @account_id = ] account_id OUTPUT ]

Bağımsız değişkenler

[ @ hesap_adı =] 'account_name'
Hesap eklemek için adı.account_nameİş sysname, ile hiçbir varsayılan.
[ @ e-posta_adresi =] 'email_address'
Gelen iletiyi göndermek için e-posta adresi.Bu adresi, bir Internet e-posta adresi olmalıdır.email_addressİş nvarchar(128), ile hiçbir varsayılan.Örneğin, bir hesap için SQL Server Aracısı, e-posta adresinden göndermek SqlAgent@Adventure-Works.com.
[ @ görüntü_adı =] 'display_name'
Bu hesaptan e-posta iletilerinde kullanılacak görüntü adı.display_nameİş nvarchar(128), varsayılan değer null.Örneğin, bir hesap için SQL Server Aracısı adını görüntüleyebilir SQL Server Agent otomatik postacı e-posta iletileri.
[ @ replyto_address =] 'replyto_address'
Bu hesaptan iletilere yanıtların gönderildiği adres.replyto_addressİş nvarchar(128), varsayılan değer null.Örneğin, bir hesap için yanıtlar SQL Server Aracısı Git veritabanı yöneticisi, danw@Adventure-Works.com.
[ @ description =] 'description'
Hesap için bir açıklama verilmiştir.descriptionİş nvarchar(256), varsayılan değer null.
[ @ mailserver_name =] 'server_name'
Adı veya bu hesabı için kullanılacak SMTP posta sunucusunun IP adresi.Çalıştıran bilgisayarın SQL Server çözümleyebilmeleri gerekir server_name için bir IP adresi.server_nameİş sysname, ile hiçbir varsayılan.
[ @ mailserver_type =] 'server_type'
E-posta sunucusu türü.server_typeİş sysname, varsayılan değer 'SMTP'...
[ @port = ] port_number
E-posta sunucusu bağlantı noktası numarası.port_numberİş int, varsayılan değer 25.
[ kullanıcıadı @ =] 'username'
E-posta sunucusuna oturum açmak için kullanılacak kullanıcı adı.usernameİş nvarchar(128), varsayılan değer null.Bu parametre null olduğunda, veritabanı posta için bu hesabı kimlik doğrulaması kullanmaz.Posta sunucusu kimlik doğrulamasıgerektirmez, null kullanıcı adı için kullanın.
[ @ parola =] 'password'
E-posta sunucusuna oturum açmak için kullandığınız paroladır.passwordİş nvarchar(128), varsayılan değer null.Bir kullanıcı adı belirtilmediği sürece bir parola sağlamak için gerek yoktur.
[ @ use_default_credentials =] use_default_credentials
kimlik bilgileri kullanarak SMTP sunucusuna posta gönderilip gönderilmeyeceğini belirtir SQL Server Veritabanı Altyapısı.use_default_credentials , varsayılan değeri 0 bit.Bu parametre 1 olduğunda, veritabanı posta kimlik bilgileri kullanan Veritabanı Altyapısı.Bu parametre 0 olduğunda, Database Mail gönderir @ kullanıcı adı ve @ parola parametreleri varsa, aksi halde gönderir posta olmadan @ kullanıcı adı ve @ parola parametreleri.
[ @ enable_ssl =] enable_ssl
Database Mail Güvenli Yuva Katmanıkullanarak iletişimi şifreler olup olmadığını belirtir.Enable_ssl , varsayılan değeri 0 bit.
[ @ account_id =] account_id Çıktı
Yeni hesap için hesap kimliği döndürür.account_idİş int, varsayılan değer null.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (başarısız)

Açıklamalar

Veritabanı posta için ayrı parametreleri sağlar @ e-posta_Adresi, @ görüntü_adı, ve @ replyto_address.@ E-posta_Adresi parametresi, iletinin gönderildiği adresi.@ Görüntü_adı parametresidir gösterilen ad dan: e-posta iletisinialan .@ Replyto_address parametre e-posta iletisi için yanıtların gönderileceği adresi olur.Örneğin, bir hesap için kullanılan SQL Server Aracısı yalnızca kullanılan için bir e-posta adresinden gelen e-posta iletileri göndermek SQL Server Aracısı.Bu adrese gelen iletileri, böylece alıcılar, kolayca belirleyebilir, kolay bir ad görüntülenmelidir SQL Server aracı gönderilen ileti.Alıcı iletiyi yanıtladığında, yanıt veritabanı yöneticisi tarafından kullanılan adres yerine gidin SQL Server Aracısı.Bu senaryo için hesabı kullanan SqlAgent@Adventure-Works.com e-posta adresi.Görünen ad küme için ise SQL Server Agent otomatik postacı.Hesabını kullanan danw@Adventure-Works.com adrese yanıt, bu nedenle bu hesaptan Gönderilmiş iletilere yanıtların Git için e-posta adresi yerine veritabanı yöneticisi SQL Server Aracısı.Üç bu parametreler için bağımsız ayarları sağlayarak, veritabanı posta iletileri gereksinimlerinize uyacak şekilde yapılandırmanıza olanak sağlar.

@ Mailserver_type parametresi sağlanan esneklik gelecekteki sürümleri için.SQL Server 2005ve daha sonra değeri destekler 'SMTP' için @ mailserver_type.

Zaman @ use_default_credentials 1 posta kimlik bilgileri kullanarak SMTP sunucusuna gönderilen SQL Server Veritabanı Altyapısı.Zaman @ use_default_credentials 0'dır ve bir @ kullanıcı adı ve @ parola belirtilmiş bir hesap için hesap SMTP kimlik doğrulamasıkullanır.@ Kullanıcı adı ve @ parola hesabını kullanır değil kimlik bilgileri için SMTP sunucusu kimlik bilgileri SQL Server ya da bilgisayar ağı.

saklı yordamsysmail_add_account_sp içinde msdb veritabanı ve sahibi dbo şema. Geçerli veritabanı değilse, yordamı üç bölümlü adı ile yürütülmelidir msdb.

İzinler

Yürütme izinleri için bu yordamı varsayılan üyelerine sysadmin sabit sunucu rolü.

Örnekler

Aşağıdaki örnek, adlı bir hesap oluşturur AdventureWorks2008R2 Administrator.E-posta adresi hesabını kullanan dba@Adventure-Works.com posta SMTP posta sunucusuna gönderir ve smtp.Adventure-Works.com.Bu hesap gösterisinden gönderilen iletileri e-posta AdventureWorks2008R2 Automated Mailer , dan: ileti satırı.İletilere yanıtların yönlendirilir danw@Adventure-Works.com.

EXECUTE msdb.dbo.sysmail_add_account_sp
    @account_name = 'AdventureWorks2008R2 Administrator',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@Adventure-Works.com',
    @display_name = 'AdventureWorks2008R2 Automated Mailer',
    @mailserver_name = 'smtp.Adventure-Works.com' ;