Share via

  • Artykuł

sysmail_add_account_sp (Transact-SQL)

Tworzy nowe konto poczty bazy danych, w którym są przechowywane informacje dotyczące konta SMTP.

Topic link iconKonwencje składni języka Transact-SQL

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'
    The name of the account to add.account_name is sysname, with no default.

  • [ @ email_address = ] "email_address'
    Proste przypadek wyrażenie działa poprzez porównanie pierwszego wyrażenia do wyrażenia w klauzula podczas każdego równoważności.This address must be an internet e-mail address.email_address is nvarchar(128), with no default.Na przykład konto SQL Server Agent może wysyłać wiadomości e-mail z adresu SqlAgent@Adventure-Works.com.

  • [ @ display_name = ] "display_name'
    Wyświetlana nazwa przeznaczona do użycia w wiadomościach e-mail wysyłanych z tego konta.Wartość display_name jest wartością typu nvarchar(128) i domyślnie jest równa NULL.Na przykład w wiadomościach e-mail wysyłanych z konta programu SQL Server Agent może być widoczna nazwa Automatyczna poczta programu SQL Server Agent.

  • [ @ replyto_address = ] "replyto_address'
    The address that responses to messages from this account are sent to.replyto_address is nvarchar(128), with a default of NULL.Na przykład odpowiada na konto SQL Server Agent może przejść do administrator bazy danych danw@Adventure-Works.com.

  • [ Opis @= ] "description'
    Is a description for the account.description is nvarchar(256), with a default of NULL.

  • [ @ mailserver_name = ] "server_name'
    przypadek wyrażenie nie można użyć do sterowania przepływem wykonania instrukcja języka Transact-SQL, bloków instrukcja, funkcji zdefiniowanych przez użytkownika i procedur przechowywanych.The computer that runs SQL Server must be able to resolve the server_name to an IP address.server_name is sysname, with no default.

  • [ @ mailserver_type = ] 'server_type"
    The type of e-mail server.server_type is sysname, with a default of 'SMTP'..

  • [ @port = ] port_number
    The port number for the e-mail server.port_number is int, with a default of 25.

  • [ nazwa_użytkownika @ = ] "username'
    Nazwa użytkownika umożliwiająca logowanie do serwera poczty e-mail.Wartość username jest wartością typu nvarchar(128) i domyślnie jest równa NULL.Gdy ten parametr ma wartość NULL, funkcja poczty bazy danych nie używa uwierzytelniania dla tego konta.Jeśli serwer poczty nie wymaga uwierzytelniania, można użyć wartości NULL dla parametru username.

  • [ @ hasła = ] "password'
    The password to use to log on to the e-mail server.password is nvarchar(128), with a default of NULL.Za pomocą przypadek w klauzula ORDER BY

  • [ @ use_default_credentials =] use_default_credentials
    Określa, czy wysłać wiadomość pocztową do serwera SMTP przy użyciu poświadczeń programu SQL Server Database Engine.Parametr use_default_credentials to bit o wartości domyślnej równej 0.Gdy ten parametr ma wartość 1, funkcja poczty bazy danych używa poświadczeń programu Database Engine.Gdy ten parametr ma wartość 0, funkcja poczty bazy danych wysyła parametry @username i @password, jeśli są dostępne, a jeśli nie są dostępne, wysyła pocztę bez parametrów @username i @password.

  • [ @enable_ssl = ] enable_ssl
    E.Enable_ssl jest bit z domyślną 0.

  • [ @account_id = ] account_id OUTPUT
    Returns the account id for the new account.account_id is int, with a default of NULL.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

The @mailserver_type parameter is provided for flexibility in future releases.SQL Server 2005 and later supports the value 'SMTP' for @mailserver_type.

Kiedy @ use_default_credentials jest 1 poczta jest wysyłana do serwera SMTP przy użyciu poświadczenia SQL Server Database Engine. Kiedy @ use_default_credentials is 0 and a nazwa_użytkownika @ and @ hasła określone dla konta, konto używa uwierzytelnianie SMTP.The @username and @password are the poświadczenia the account uses for the SMTP server, not poświadczenia for SQL Server or the network that the computer is on.

Procedura przechowywana sysmail_add_account_sp is in the msdb bazy danych, a właścicielem dbo schematu.Procedura musi być wykonane o nazwie trzy części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia dla tej wartości domyślnej procedury do członków do wykonywania sysadmin ustalić roli serwera.

Przykłady

W poniższym przykładzie jest tworzone konto o nazwie AdventureWorks Administrator.To konto używa adresu e-mail dba@Adventure-Works.com i wysyła pocztę do serwera poczty SMTP smtp.Adventure-Works.com.W wierszu Od: w wiadomościach e-mail wysyłanych z tego konta jest widoczna nazwa AdventureWorks Automated Mailer.Odpowiedzi na te wiadomości są kierowane na adres danw@Adventure-Works.com.

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