sysmail_update_account_sp (Transact-SQL)

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

Convenzioni della 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 , 
    [ @username = ] 'username' ,
    [ @password = ] 'password' ,
    [ @use_default_credentials = ] use_default_credentials ,
    [ @enable_ssl = ] enable_ssl 

Argomenti

• [ @account_id = ] account_id
  ID dell'account che si desidera aggiornare. account_id è di tipo int e il valore predefinito è NULL. È necessario specificare account_id o account_name. Se si specificano entrambi, la stored procedure modifica il nome dell'account.

• [ @account_name = ] 'account_name'
  Nome dell'account che si desidera aggiornare. account_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare 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 è di tipo nvarchar(128) e il valore predefinito è NULL.

• [ @display_name = ] 'display_name'
  Nuovo nome visualizzato da utilizzare nei messaggi di posta elettronica provenienti da questo account. display_name è di tipo nvarchar(128) e non prevede alcun valore predefinito.

• [ @replyto_address = ] 'replyto_address'
  Nuovo indirizzo da utilizzare nel campo Risposta dei messaggi di posta elettronica inviati da questo account. replyto_address è di tipo nvarchar(128) e non prevede alcun valore predefinito.

• [ @description= ] 'description'
  Nuova descrizione dell'account. description è di tipo nvarchar(256) e il valore predefinito è NULL.

• [ @mailserver_name = ] 'server_name'
  Nome del nuovo server di posta elettronica SMTP da utilizzare per l'account. Il computer in cui è in esecuzione Microsoft SQL Server deve essere in grado di risolvere il valore di server_name in un indirizzo IP. server_name è di tipo sysname e non prevede alcun valore predefinito.

• [ @mailserver_type = ] 'server_type'
  Tipo del nuovo server di posta elettronica. server_type è di tipo sysname e non prevede alcun valore predefinito. Per Microsoft SQL Server 2005 è supportato solo 'SMTP'.

• [ @port = ] port_number
  Nuovo numero di porta del server di posta elettronica. port_number è di tipo int e non prevede alcun valore predefinito.

• [ @username = ] 'username'
  Nuovo nome utente da utilizzare per l'accesso al server di posta elettronica. username è di tipo sysname e non prevede alcun valore predefinito.

• [ @password = ] 'password'
  Nuova password da utilizzare per l'accesso al server di posta elettronica. password è di tipo sysname e non prevede alcun valore predefinito.

• [ @use_default_credentials = ] use_default_credentials
  Specifica se inviare il messaggio al server SMTP utilizzando le credenziali del servizio Motore di database di SQL Server. use_default_credentials è di tipo bit e non prevede alcun valore predefinito. Se questo parametro è 1, Posta elettronica database utilizza le credenziali di Motore di database di SQL Server. Se questo parametro è 1, Posta elettronica database utilizza @username e @password per l'autenticazione sul server SMTP. Se il valore di @username e @password è NULL viene utilizzata l'autenticazione anonima. Prima di specificare questo parametro consultare l'amministratore del server SMTP.

• [ @enable_ssl = ] enable_ssl
  Specifica l'utilizzo della crittografia mediante SSL (Secure Sockets Layer) da parte di Posta elettronica database. Utilizzare questa opzione se SSL è obbligatorio per il server SMTP. enable_ssl è di tipo bit e non prevede alcun valore predefinito.

Osservazioni

Se si specificano sia il nome dell'account che l'ID dell'account, la stored procedure modifica il nome dell'account, oltre ad aggiornare le informazioni relative all'account. Questo può essere utile se è necessario correggere un errore nel nome dell'account.

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

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Modifica delle informazioni di un account

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

EXECUTE 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,
    @username = NULL ,
    @password = NULL ,
    @use_default_credentials = 0 ,
    @enable_ssl = 0 ;

B. Modifica del nome e delle informazioni di un account

Nell'esempio seguente vengono modificati il nome e le informazioni dell'account con ID 125. Il nuovo nome dell'account è Backup Mail Server.

EXECUTE 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,
    @username = NULL ,
    @password = NULL ,
    @use_default_credentials = 0 ,
    @enable_ssl = 0 ;

Vedere anche

Riferimento

Stored procedure di Posta elettronica database e SQL Mail (Transact-SQL)

Altre risorse

Posta elettronica database
Account di Posta elettronica database
Selezione attività di configurazione (Posta elettronica database)

Guida in linea e informazioni

Assistenza su SQL Server 2005