sysmail_update_profile_sp (Transact-SQL)

Artikel
06/18/2013

Ändert die Beschreibung oder den Namen eines Profils für Datenbank-E-Mail.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @profile_id = ] profile_id
Die zu aktualisierende Profil-ID. profile_id ist vom Datentyp int. Der Standardwert ist NULL. Es muss mindestens profile_id oder profile_name angegeben werden (es können auch beide angegeben werden). Werden beide Werte angegeben, wird der Name des Profils geändert.
[ @profile_name = ] 'profile_name'
Der Name des zu aktualisierenden Profils oder der neue Name für das Profil. profile_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es muss mindestens profile_id oder profile_name angegeben werden (es können auch beide angegeben werden). Werden beide Werte angegeben, wird der Name des Profils geändert.
[ @description = ] 'description'
Die neue Beschreibung für das Profil. description ist vom Datentyp nvarchar(256). Der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Wenn sowohl die Profil-ID als auch der Profilname angegeben werden, wird der Name des Profils zum bereitgestellten Namen geändert und die Beschreibung des Profils aktualisiert. Wenn nur eins dieser Argumente bereitgestellt wird, wird die Beschreibung des Profils aktualisiert.

Die gespeicherte Prozedur sysmail_update_profile_sp befindet sich in der msdb-Datenbank und im Besitz des dbo-Schemas. 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. Ändern der Beschreibung eines Profils

Im folgenden Beispiel wird die Beschreibung für das Profil mit dem Namen AdventureWorks Administrator in der msdb-Datenbank geändert.

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

B. Ändern des Namens und der Beschreibung eines Profils

Im folgenden Beispiel wird der Name und die Beschreibung des Profils mit der Profil-ID 750 geändert.

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