sysmail_update_account_sp (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Modifica le informazioni di un account di Posta elettronica database esistente.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @account_id = ] account_id

ID dell'account da aggiornare. @account_id è int, con il valore predefinito NULL. È necessario specificare almeno una delle @account_id o @account_name . Se si specificano entrambi, la stored procedure modifica il nome dell'account.

[ @account_name = ] 'account_name'

Nome dell'account da aggiornare. @account_name è sysname, con un valore predefinito .NULL È necessario specificare almeno una delle @account_id o @account_name . Se si specificano entrambi, la stored procedure modifica il nome dell'account.

[ @email_address = ] 'email_address'

Nuovo indirizzo di posta elettronica da cui inviare il messaggio. Deve essere un indirizzo di posta elettronica Internet. Il nome del server nell'indirizzo è il server utilizzato da Posta elettronica database per l'invio di posta da questo account. @email_address è nvarchar(128), con il valore predefinito NULL.

[ @display_name = ] 'display_name'

Nuovo nome visualizzato da utilizzare nei messaggi di posta elettronica provenienti da questo account. @display_name è nvarchar(128), senza impostazione predefinita.

[ @replyto_address = ] 'replyto_address'

Nuovo indirizzo da utilizzare nel campo Risposta dei messaggi di posta elettronica inviati da questo account. @replyto_address è nvarchar(128), senza impostazione predefinita.

[ @description = ] 'description'

Nuova descrizione dell'account. @description è nvarchar(256), con il valore predefinito NULL.

[ @mailserver_name = ] 'server_name'

Nome del nuovo server di posta elettronica SMTP da utilizzare per l'account. Il computer che esegue SQL Server deve essere in grado di risolvere il @mailserver_name in un indirizzo IP. @mailserver_name è sysname, senza impostazione predefinita.

[ @mailserver_type = ] 'server_type'

Nuovo tipo del server di posta elettronica. @mailserver_type è sysname, senza impostazione predefinita. È supportato solo un valore di SMTP .

[ @port = ] port_number

Nuovo numero di porta del server di posta elettronica. @port è int, senza impostazione predefinita.

[ @timeout = ] 'timeout'

Parametro di timeout per SmtpClient.Send un singolo messaggio di posta elettronica. @timeout è int in secondi, senza impostazione predefinita.

[ @username = ] 'username'

Nuovo nome utente da utilizzare per l'accesso al server di posta elettronica. @username è sysname, senza impostazione predefinita.

[ @password = ] 'password'

Nuova password da utilizzare per l'accesso al server di posta elettronica. @password è sysname, senza impostazione predefinita.

[ @use_default_credentials = ] use_default_credentials

Specifica se inviare la posta elettronica al server SMTP utilizzando le credenziali del servizio motore di database DI SQL Server. @use_default_credentials è bit, senza impostazione predefinita. Quando questo parametro è 1, Posta elettronica database usa le credenziali del motore di database. Quando questo parametro è 0, Posta elettronica database usa il @username e @password per l'autenticazione nel server SMTP. Se @username e @password sono NULL, usa l'autenticazione anonima. Prima di specificare questo parametro consultare l'amministratore del server SMTP.

[ @enable_ssl = ] enable_ssl

Specifica se Posta elettronica database crittografa la comunicazione tramite Transport Layer Security (TLS), nota in precedenza come Secure Sockets Layer (SSL). Usare questa opzione se TLS è necessario nel server SMTP. @enable_ssl è bit, senza impostazione predefinita.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Quando vengono specificati sia il nome dell'account che l'ID account, la stored procedure modifica il nome dell'account oltre ad aggiornare le informazioni per l'account. La modifica del nome dell'account è utile per correggere gli errori nel nome dell'account.

La stored procedure sysmail_update_account_sp si trova nel msdb database ed è di proprietà dello dbo schema. La procedura deve essere eseguita con un nome in tre parti se il database corrente non msdbè .

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

Esempi

R. Modificare le informazioni per un account

Nell'esempio seguente viene aggiornato l'account AdventureWorks Administrator Nel msdb database. Le informazioni dell'account vengono impostate in base ai valori specificati.

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. Modificare il nome di un account e le informazioni per un account

L'esempio seguente modifica il nome e aggiorna le informazioni sull'account per l'oggetto con ID 125account . Il nuovo nome dell'account è 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;

Contenuto correlato