sysmail_delete_principalprofile_sp (Transact-SQL)

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

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
  Die ID des Datenbankbenutzers oder der Datenbankrolle in der msdb-Datenbank für die Zuordnung, die gelöscht werden soll. principal_id ist vom Datentyp int. Der Standardwert ist 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'
  Der Name des Datenbankbenutzers oder der Datenbankrolle in der msdb-Datenbank für die Zuordnung, die gelöscht werden soll. principal_name ist vom Datentyp sysname. Der Standardwert ist 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 ID des Profils für die Zuordnung, die gelöscht werden soll. profile_id ist vom Datentyp int. Der Standardwert ist 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 ist vom Datentyp sysname. Der Standardwert ist 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 (Transact-SQL)

Konzepte

Datenbank-E-Mail

Konfigurationsobjekte für Datenbank-E-Mail