Udostępnij za pośrednictwem

  • Artykuł

sysmail_add_account_sp (języka Transact-SQL)

Tworzy nowe konto pocztowe bazy danych, informacje o koncie SMTP .

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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 ]

Argumenty

  • [ @ nazwa_konta =] 'account_name"
    Nazwa konta, aby dodać.account_namejest sysname, z braku domyślne.

  • [ @ Adres_email =] 'email_address"
    Adres e-mail, aby wysłać wiadomość z.Ten adres musi być internetowego adresu e-mail.email_addressjest nvarchar(128), z braku domyślne.Na przykład konto dla SQL Server Agent może wysyłać wiadomości e-mail z adresu SqlAgent@Adventure-Works.com.

  • [ @ display_name =] 'display_name"
    Nazwa wyświetlana na wiadomości e-mail z tego konta.display_namejest nvarchar(128), domyślna wartość NULL.Na przykład konto dla SQL Server Agent może wyświetlić nazwę ProgramuSQL Server Agent automatycznego poczty w wiadomości e-mail.

  • [ @ replyto_address =] 'replyto_address"
    Odpowiedzi na wiadomości z tego konta są wysyłane na adres.replyto_addressjest nvarchar(128), domyślna wartość NULL.Na przykład odpowiada na konto dla SQL Server Agent może przejść do administrator bazy danych danw@Adventure-Works.com.

  • [ Opis @ =] 'description"
    Znajduje się opis konta.descriptionjest nvarchar(256), domyślna wartość NULL.

  • [ @ mailserver_name =] 'server_name"
    Nazwa lub adres IP serwera poczty SMTP dla tego konta.Komputer z systemem SQL Server musi być w stanie rozwiązać server_name do adresu IP.server_namejest sysname, z braku domyślne.

  • [ @ mailserver_type =] "server_type'
    Typ serwera poczty e-mail.server_typejest sysname, domyślnie "SMTP"...

  • [ @port = ] port_number
    Numer portu serwera poczty e-mail.port_numberjest int, domyślna wartość 25.

  • [ nazwa_użytkownika @ =] 'username"
    Nazwa użytkownika używana do logowania na serwerze poczty e-mail.usernamejest nvarchar(128), domyślna wartość NULL.Jeśli ten parametr ma wartość NULL, bazy danych poczty nie korzysta z uwierzytelnianie dla tego konta.Jeśli serwer poczty nie wymaga uwierzytelnianie, należy użyć wartości NULL nazwy użytkownika.

  • [ hasło @ =] 'password"
    Hasło używane do logowania się na serwerze poczty e-mail.passwordjest nvarchar(128), domyślna wartość NULL.Nie ma potrzeby o podanie hasła, o ile nie określono nazwy użytkownika.

  • [ @ use_default_credentials =] use_default_credentials
    Określa, czy wysyłanie poczty do serwera SMTP przy użyciu poświadczenia Aparat baz danych programu SQL Server.use_default_credentials jest bit domyślna wartość 0.Jeśli ten parametr ma wartość 1, poczta bazy danych używa poświadczenia Aparat baz danych.Kiedy ten parametr ma wartość 0, wysyła poczty bazy danych nazwa_użytkownika @ i hasło @ parametry, jeśli jest obecny, w przeciwnym razie wysyła pocztę bez nazwa_użytkownika @ i hasło @ parametry.

  • [ @ enable_ssl =] enable_ssl
    Określa, czy poczta bazy danych szyfruje komunikacji przy użyciu Secure Sockets Layer.Enable_ssl jest bit domyślna wartość 0.

  • [ @ account_id =] account_id danych wyjściowych
    Zwraca identyfikator konta dla nowego konta.account_idjest int, domyślna wartość NULL.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

Poczta bazy danych zawiera osobne parametry dla @ Adres_email, @ display_name, i @ replyto_address.@ Adres_email parametr jest adres, z której wiadomość jest wysyłana.@ Display_name parametr ma nazwę wyświetlaną w Z: pole wiadomości e-mail.@ Replyto_address parametr jest to adres, którego wysyłane odpowiedzi na wiadomość e-mail.Na przykład konto używane do SQL Server Agent może wysyłać wiadomości e-mail z adresu e-mail służy tylko do SQL Server agenta.Wiadomości od tego adresu powinien być wyświetlany przyjazną nazwę, dzięki czemu adresaci łatwo można określić, SQL Server Agent wysyłane wiadomości.Jeśli adresat odpowiedzi na wiadomość, odpowiedź, należy przejść do administrator bazy danych , a nie adres używany przez SQL Server agenta.W tym scenariuszu używa konta SqlAgent@Adventure-Works.com jako adres e-mail.Nazwa wyświetlana jest zestaw na ProgramuSQL Server Agent automatycznego poczty.Używa konta danw@Adventure-Works.com jako odpowiedź na adres tak odpowiedzi na wiadomości wysłanych z tego konta Przejdź do administrator bazy danych zamiast adresu e-mail dla SQL Server agenta.Dostarczając niezależne ustawienia dla tych trzech parametrów poczty bazy danych pozwala na konfigurowanie wiadomości do własnych potrzeb.

@ Mailserver_type parametr jest przewidziane w przyszłości zwalnia elastyczność.SQL Server 2005obsługuje wartości "SMTP" dla @ mailserver_type.

Gdy @ use_default_credentials jest 1 poczta jest wysyłana do serwera SMTP przy użyciu poświadczenia Aparat baz danych programu SQL Server.Gdy @ use_default_credentials jest równa 0 i nazwa_użytkownika @ i hasło @ określone dla konta, konto używauwierzytelnianie SMTP. Nazwa_użytkownika @ i hasło @ są poświadczenia konta używa serwera SMTP nie poświadczenia dla SQL Server lub sieci, do której komputer jest włączony.

procedura składowanasysmail_add_account_sp w msdb bazy danych i jest w posiadaniu dbo schematu. Procedury muszą być wykonane z nazwą trzech części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia domyślne tej procedury do członków wykonywania sysadmin stała rola serwera.

Przykłady

Poniższy przykład tworzy konto o nazwie AdventureWorks2008R2 Administrator.Adres e-mail używa konta dba@Adventure-Works.com i wysyła pocztę do serwera poczty SMTP smtp.Adventure-Works.com.Wiadomości e-mail wysyłane z tego pokazu konta AdventureWorks2008R2 Automated Mailer na Z: wiersz wiadomości.Odpowiedzi na wiadomości są kierowane do 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' ;