sysmail_delete_profileaccount_sp (Transact-SQL)
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 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' ;
Siehe auch
Verweis
Gespeicherte Prozeduren für Datenbank-E-Mail und SQL Mail (Transact-SQL)
Andere Ressourcen
Datenbank-E-Mail
Konfigurationsaufgabe auswählen (Datenbank-E-Mail)
Datenbank-E-Mail-Konten
Datenbank-E-Mail-Profile