Freigeben über


sysmail_update_profile_sp (Transact-SQL)

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

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 und hat den Standardwert 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 des Profils. profile_name ist vom Datentyp sysname und hat den Standardwert 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 des Profils. description ist vom Datentyp nvarchar(256) und hat den Standardwert 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.';