sysmail_delete_profileaccount_sp (Transact-SQL)
Supprime un compte d'un profil de messagerie de base de données.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de Transact-SQL
Syntaxe
sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
Arguments
- [ @profile_id = ] profile_id
Identificateur du profil à supprimer. profile_id est de type int et la valeur par défaut est NULL. L'argument profile_id ou profile_name peut être spécifié.
- [ @profile_name = ] 'profile_name'
Nom du profil à supprimer. profile_name est de type sysname et sa valeur par défaut est NULL. L'argument profile_id ou profile_name peut être spécifié.
- [ @account_id = ] account_id
ID du compte à supprimer. account_id est de type int, avec NULL comme valeur par défaut. L'argument account_id ou account_name peut être spécifié.
- [ @account_name = ] 'account_name'
Nom du compte à supprimer. L'argument account_name est de type sysname, avec NULL comme valeur par défaut. L'argument account_id ou account_name peut être spécifié.
Notes
Renvoie une erreur si le compte spécifié n'est pas associé au profil spécifié.
Lorsqu'un compte est spécifié mais pas un profil, cette procédure stockée supprime le compte spécifié de tous les profils. Par exemple, pour fermer un serveur SMTP existant, supprimez de tous les profils les comptes qui utilisent le serveur SMTP en question au lieu de supprimer chaque compte de chaque profil.
Lorsqu'un profil est spécifié mais pas un compte, cette procédure stockée supprime tous les comptes du profil spécifié. Par exemple, pour modifier les serveurs SMTP utilisés par un profil, il peut être pratique de supprimer tous les comptes du profil et d'ajouter ensuite les nouveaux comptes.
La procédure stockée sysmail_delete_profileaccount_sp se trouve dans la base de données msdb et appartient au schéma dbo. La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n'est pas msdb.
Autorisations
Les autorisations d'exécution de cette procédure sont accordées par défaut aux membres du rôle de serveur fixe sysadmin.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Ensembles de résultats
Aucun
Exemple
L'exemple suivant montre la suppression du compte Audit Account du profil AdventureWorks Administrator.
EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account' ;
Voir aussi
Référence
Procédures stockées de messagerie de base de données et SQL Mail (Transact-SQL)
Autres ressources
Messagerie de base de données
Sélectionner une tâche de configuration (messagerie de base de données)
Comptes de messagerie de base de données
Profils de messagerie de base de données