sysmail_delete_profile_sp (Transact-SQL)
Gilt für: SQL Server
Löscht ein von Datenbank-E-Mail verwendetes E-Mail-Profil.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]
Argumente
[ @profile_id = ] profile_id
Die Profil-ID des zu löschenden Profils. @profile_id ist int, mit einem Standardwert von NULL
. Entweder @profile_id oder @profile_name müssen angegeben werden.
[ @profile_name = ] 'profile_name'
Der Name des zu löschenden Profils. @profile_name ist "sysname" mit der Standardeinstellung "NULL
. Entweder @profile_id oder @profile_name müssen angegeben werden.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Keine.
Hinweise
Durch das Löschen eines Profils werden die vom Profil verwendeten Konten nicht gelöscht.
Durch diese gespeicherte Prozedur wird das Profil unabhängig davon gelöscht, ob Benutzer auf das Profil zugreifen können. Achten Sie beim Entfernen des standardmäßigen privaten Profils für einen Benutzer oder das standard öffentliche Profil für die msdb
Datenbank. Wenn kein Standardprofil verfügbar ist, sp_send_dbmail
ist der Name eines Profils als Argument erforderlich. Daher kann das Entfernen eines Standardprofils dazu führen, dass Aufrufe sp_send_dbmail
fehlschlagen. Weitere Informationen finden Sie unter sp_send_dbmail.
Die gespeicherte Prozedur sysmail_delete_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
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
Im folgenden Beispiel wird gezeigt, wie das Profil AdventureWorks Administrator
gelöscht wird.
EXEC msdb.dbo.sysmail_delete_profile_sp
@profile_name = 'AdventureWorks Administrator';