Freigeben über

sysmail_delete_principalprofile_sp (Transact-SQL)

  • Artikel

Aktualisiert: 12. Dezember 2006

Entfernt für einen Benutzer einer msdb-Datenbank oder eine public-Rolle die Berechtigung zum Verwenden eines öffentlichen oder privaten Datenbank-E-Mail-Profils.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sysmail_delete_principalprofile_sp  { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }

Argumente

  • [ @principal_id = ] principal_id
    Entspricht der ID des msdb-Datenbankbenutzers bzw. 0 für die public-Rolle. principal_id entspricht int, der Standardwert lautet NULL. Wenn ein öffentliches in ein privates Profil umgewandelt werden soll, geben Sie als Prinzipal-ID 0 oder den Prinzipalnamen 'public' an. Es muss entweder principal_id oder principal_name angegeben werden.
  • [ @principal_name = ] 'principal_name'
    Entspricht dem Namen des msdb-Datenbankbenutzers oder 'public' für die public-Rolle. principal_name entspricht sysname, der Standardwert lautet NULL. Wenn ein öffentliches in ein privates Profil umgewandelt werden soll, geben Sie als Prinzipal-ID 0 oder den Prinzipalnamen 'public' an. Es muss entweder principal_id oder principal_name angegeben werden.
  • [ @profile_id = ] profile_id
    Die Profil-ID der Zuordnung, die gelöscht werden soll. profile_id hat den Datentyp int und den Standardwert NULL. Es muss entweder profile_id oder profile_name angegeben werden.
  • [ @profile_name = ] 'profile_name'
    Der Name des Profils für die Zuordnung, die gelöscht werden soll. profile_name hat den Datentyp sysname und den Standardwert NULL. Es muss entweder profile_id oder profile_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Wenn ein öffentliches Profil in ein privates Profil umgewandelt werden soll, geben Sie als Prinzipal-ID 0 oder den Prinzipalnamen 'public' an.

Gehen Sie vorsichtig vor, wenn Sie für einen Benutzer die Berechtigungen für das private Standardprofil entfernen oder das öffentliche Standardprofil entfernen. Wenn kein Standardprofil verfügbar ist, ist für sp_send_dbmail der Name eines Profils als Argument erforderlich. Deshalb kann das Entfernen eines Standardprofils dazu führen, dass Aufrufe von sp_send_dbmail einen Fehler erzeugen. Weitere Informationen finden Sie unter sp_send_dbmail (Transact-SQL).

Die gespeicherte Prozedur sysmail_delete_principalprofile_sp wird in der msdb-Datenbank gespeichert, der Besitzer ist das dbo-Schema. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Die Ausführungsberechtigungen erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die Zuordnung zwischen dem Profil AdventureWorks Administrator und dem Anmeldenamen ApplicationUser in der msdb-Datenbank gelöscht wird.

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator' ;

Siehe auch

Verweis

Gespeicherte Prozeduren für Datenbank-E-Mail und SQL Mail (Transact-SQL)

Andere Ressourcen

Datenbank-E-Mail
Datenbank-E-Mail-Profile
Konfigurationsaufgabe auswählen (Datenbank-E-Mail)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

12. Dezember 2006
Geänderter Inhalt:
  • Benutzer wurden als msdb-Benutzer angegeben, und diese Rolle ist auf die public-Rolle beschränkt.