sysmail_update_profile_sp (Transact-SQL)

Si applica a: SQL Server

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

Convenzioni relative alla 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 è int, con il valore predefinito NULL. È necessario specificare almeno uno dei @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 è sysname, con il valore predefinito NULL. È necessario specificare almeno uno dei @profile_id o @profile_name . Se si specificano entrambi, la procedura modifica il nome del profilo.

[ @description = ] 'description'

Nuova descrizione del profilo. @description è nvarchar(256), con il valore predefinito NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Quando vengono specificati sia l'ID del profilo che il nome del profilo, la procedura modifica il nome del profilo con il nome specificato e aggiorna la descrizione per il profilo. Se si specifica solo uno di questi argomenti, la procedura aggiorna la descrizione del profilo.

La stored procedure sysmail_update_profile_sp si trova nel msdb database ed è di proprietà dello schema dbo . 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 la descrizione di un profilo

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

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Administrative mail profile.';

B. Modificare il nome e la descrizione di un profilo

Nell'esempio seguente viene modificato il nome e la descrizione del profilo con l'ID 750del profilo .

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