sysmail_add_profile_sp (Transact-SQL)

Artikel
06/18/2013

Erstellt ein neues Profil für Datenbank-E-Mail.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @profile_name = ] 'profile_name'
Der Name des neuen Profils. profile_name ist vom Datentyp sysname und hat keinen Standardwert.
[ @description = ] 'description'
Die optionale Beschreibung für das neue Profil. description ist vom Datentyp nvarchar(256) und hat keinen Standardwert.
[ @profile_id = ] new_profile_idOUTPUT
Gibt die ID für das neue Profil zurück. new_profile_id ist vom Datentyp int. Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Ein Datenbank-E-Mail-Profil kann eine beliebige Anzahl von Datenbank-E-Mail-Konten enthalten. Gespeicherte Prozeduren von Datenbank-E-Mail können nach dem Profilnamen oder der von dieser Prozedur generierten Profil-ID auf ein Profil verweisen. Weitere Informationen zum Hinzufügen eines Kontos zu einem Profil finden Sie unter sysmail_add_profileaccount_sp (Transact-SQL).

Der Profilname und die Beschreibung können mit der gespeicherten Prozedur sysmail_update_profile_sp geändert werden, während die Profil-ID für die Lebensdauer des Profils konstant bleibt.

Der Profilname muss für Microsoft SQL Server Database Engine (Datenbankmodul) eindeutig sein. Andernfalls wird von der gespeicherten Prozedur ein Fehler zurückgegeben.

Die gespeicherte Prozedur sysmail_add_profile_sp befindet sich in der msdb-Datenbank mit dem dbo-Schema als Besitzer. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Über die Ausführungsberechtigungen für diese Prozedur verfügen standardmäßig die Mitglieder der festen Serverrolle sysadmin.

Beispiele

A. Erstellen eines neuen Profils

Im folgenden Beispiel wird ein neues Datenbank-E-Mail-Profil mit dem Namen AdventureWorks Administrator erstellt.

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

B. Erstellen eines neuen Profils und Speichern der Profil-ID in einer Variablen

Im folgenden Beispiel wird ein neues Datenbank-E-Mail-Profil mit dem Namen AdventureWorks Administrator erstellt. Im folgenden Beispiel wird die Profil-ID in der Variablen @profileId gespeichert, und es wird ein Resultset mit der Profil-ID für das neue Profil zurückgegeben.

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 ;