sysmail_delete_profile_sp (Transact-SQL)

  • Artikel

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 (Erfolg) 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 (Transact-SQL).

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 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

Im folgenden Beispiel wird gezeigt, wie das Profil AdventureWorks Administrator gelöscht wird.

EXEC msdb.dbo.sysmail_delete_profile_sp
    @profile_name = 'AdventureWorks Administrator';

Zugehöriger Inhalt