sysmail_delete_profileaccount_sp (Transact-SQL)
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 msdb
vorhanden 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 Administrator
entfernt.
EXEC msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account';