Teilen über


sysmail_update_profile_sp (Transact-SQL)

Gilt für: SQL Server

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

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 int, mit einem Standardwert von NULL. Mindestens ein @profile_id oder @profile_name muss 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 "sysname" mit der Standardeinstellung "NULL. Mindestens ein @profile_id oder @profile_name muss angegeben werden. Werden beide Werte angegeben, wird der Name des Profils geändert.

[ @description = ] 'description'

Die neue Beschreibung für das Profil. @description ist nvarchar(256), mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Wenn sowohl die Profil-ID als auch der Profilname angegeben werden, ändert die Prozedur den Namen des Profils in den angegebenen Namen und aktualisiert die Beschreibung für das Profil. 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 befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Beispiele

A. Ändern der Beschreibung eines Profils

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

EXEC 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 750geändert.

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