• Artikel

sysmail_delete_profileaccount_sp (Transact-SQL)

Entfernt ein Konto aus einem Datenbank-E-Mail-Profil.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sysmail_delete_profileaccount_sp  {   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    {   [ @account_id = ] account_id | [ @account_name = ] 'account_name' }

Argumente

  • [ @profile_id = ] profile_id
    Die Profil-ID des Profils, das gelöscht werden soll. profile_id ist vom Datentyp int und hat den Standardwert NULL. Es kann entweder profile_id oder profile_name angegeben werden.

  • [ @profile_name = ] 'profile_name'
    Der Profilname des Profils, das gelöscht werden soll. profile_name ist vom Datentyp sysname und hat den Standardwert NULL. Es kann entweder profile_id oder profile_name angegeben werden.

  • [ @account_id = ] account_id
    Die zu löschende Konto-ID. account_id ist vom Datentyp int und hat den Standardwert NULL. Es kann entweder account_id oder account_name angegeben werden.

  • [ @account_name = ] 'account_name'
    Der Name des zu löschenden Kontos. account_name ist vom Datentyp sysname und hat den Standardwert NULL. Es kann entweder account_id oder account_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Gibt einen Fehler zurück, wenn das angegebene Konto dem angegebenen Profil nicht zugeordnet ist.

Ist ein Konto angegeben, jedoch kein Profil, entfernt diese gespeicherte Prozedur das angegebene Konto aus allen Profilen. Wenn Sie z. B. das Herunterfahren eines vorhandenen SMTP-Servers vorbereiten, entfernen Sie Konten, die diesen SMTP-Server verwenden, aus allen Profilen, anstatt jedes Konto aus jedem einzelnen Profil zu entfernen.

Ist ein Profil angegeben, jedoch kein Konto, entfernt diese gespeicherte Prozedur alle Konten aus dem angegebenen Profil. Wenn Sie z. B. die von einem Profil verwendeten SMTP-Server ändern, können Sie alle Konten aus dem Profil entfernen und dann bei Bedarf neue Konten hinzufügen.

Die gespeicherte Prozedur sysmail_delete_profileaccount_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Über die Ausführungsberechtigungen für diese Prozedur verfügen standardmäßig die Mitglieder der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird das Konto Audit Account aus dem Profil AdventureWorks Administrator entfernt.

EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account' ;