sysmail_add_profile_sp (Transact-SQL)

Articolo
06/18/2013

Consente di creare un nuovo profilo di Posta elettronica database.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] 'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]

Argomenti

[ @profile_name = ] 'profile_name'
Nome del nuovo profilo. profile_name è di tipo sysname e non prevede alcun valore predefinito.
[ @description = ] 'description'
Descrizione facoltativa del nuovo profilo. description è di tipo nvarchar(256) e non prevede alcun valore predefinito.
[ @profile_id = ] new_profile_idOUTPUT
Restituisce l'ID del nuovo profilo. new_profile_id è di tipo int e il valore predefinito è NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Un profilo di Posta elettronica database include qualsiasi numero di account di Posta elettronica database. Le stored procedure di Posta elettronica database possono far riferimento a un profilo attraverso il nome del profilo o l'ID del profilo generato da questa procedura. Per ulteriori informazioni sull'aggiunta di un account a un profilo, vedere sysmail_add_profileaccount_sp (Transact-SQL).

Il nome e la descrizione del profilo possono essere modificati tramite la stored procedure sysmail_update_profile_sp, mentre l'ID del profilo resta invariato per tutta la durata del profilo.

Il nome del profilo deve essere univoco per Microsoft Motore di database di SQL Server. In caso contrario, la stored procedure restituisce un errore.

La stored procedure sysmail_add_profile_sp si trova 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. Creazione di un nuovo profilo

Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.' ;

B. Creazione di un nuovo profilo e salvataggio dell'ID del profilo in una variabile

Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator. Nell'esempio il numero di ID del profilo viene archiviato nella variabile @profileId e viene restituito un set di risultati contenente il numero di ID del nuovo profilo.

DECLARE @profileId INT ;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT ;

SELECT @profileId ;