sysmail_delete_profileaccount_sp (Transact-SQL)

  • Artikel

Gilt für: SQL Server

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

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 int, mit einem Standardwert von NULL. Entweder die @profile_id oder die @profile_name können angegeben werden.

[ @profile_name = ] 'profile_name'

Der Name des Profils, das gelöscht werden soll. @profile_name ist "sysname" mit der Standardeinstellung "NULL. Entweder die @profile_id oder die @profile_name können angegeben werden.

[ @account_id = ] account_id

Die zu löschende Konto-ID. @account_id ist int, mit einem Standardwert von NULL. Entweder die @account_id oder die @account_name können angegeben werden.

[ @account_name = ] 'account_name'

Der Name des zu löschenden Kontos. @account_name ist "sysname" mit der Standardeinstellung "NULL. Entweder die @account_id oder die @account_name können angegeben werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Keine.

Hinweise

Gibt einen Fehler zurück, wenn das angegebene Konto nicht mit dem angegebenen Profil verknüpft 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 Profil zu entfernen.

Ist ein Profil angegeben, jedoch kein Konto, entfernt diese gespeicherte Prozedur alle Konten aus dem angegebenen Profil. Wenn Sie beispielsweise die smtp-Server ändern, die ein Profil verwendet, kann es praktisch sein, alle Konten aus dem Profil zu entfernen und dann bei Bedarf neue Konten hinzuzufügen.

Die gespeicherte Prozedur sysmail_delete_profileaccount_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 das Konto Audit Account aus dem Profil AdventureWorks Administratorentfernt.

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

Zugehöriger Inhalt