Condividi tramite


sysmail_update_profile_sp (Transact-SQL)

Modifica la descrizione o il nome di un profilo di Posta elettronica database.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]

Argomenti

  • [ @profile_id = ] profile_id
    ID del profilo da aggiornare. profile_id è di tipo int e il valore predefinito è NULL. È necessario specificare profile_id o profile_name. Se si specificano entrambi, la procedura modifica il nome del profilo.

  • [ @profile_name = ] 'profile_name'
    Nome del profilo da aggiornare oppure nuovo nome del profilo. profile_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare profile_id o profile_name. Se si specificano entrambi, la procedura modifica il nome del profilo.

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

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Se si specificano sia l'ID che il nome del profilo, la procedura modifica il nome del profilo utilizzando il nome specificato e quindi aggiorna la descrizione del profilo. Se si specifica solo uno di questi argomenti, la procedura aggiorna la descrizione del profilo.

La stored procedure sysmail_update_profile_sp è archiviata 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.

Esempi

A. Modifica della descrizione di un profilo

Nell'esempio seguente viene modificata la descrizione del profilo denominato AdventureWorks2008R2 Administrator nel database msdb.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks2008R2 Administrator'
    ,@description = 'Administrative mail profile.';

B. Modifica del nome e delle descrizione di un profilo

Nell'esempio seguente vengono modificati il nome e la descrizione del profilo con ID 750.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750
    ,@profile_name = 'Operator'
    ,@description = 'Profile to send alert e-mail to operators.';