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 msdb
vorhanden ist.
Berechtigungen
Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE
, aber diese Berechtigungen können 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 750
geändert.
EXEC msdb.dbo.sysmail_update_profile_sp
@profile_id = 750,
@profile_name = 'Operator',
@description = 'Profile to send alert e-mail to operators.';