• Artikel

sysmail_delete_principalprofile_sp (Transact-SQL)

Entfernt für einen Benutzer einer Datenbank oder eine 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 Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die zu löschende Zuordnung. principal_id ist vom Datentyp int und hat den Standardwert 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 Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die zu löschende Zuordnung. principal_name ist vom Datentyp sysname und hat den Standardwert 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' ;