sysmail_delete_profileaccount_sp (Transact-SQL)
S'applique à : SQL Server
Supprime un compte d'un profil de messagerie de base de données.
Conventions de la syntaxe 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
ID de profil du profil à supprimer. @profile_id est int, avec la valeur par défaut NULL
. Vous pouvez spécifier la @profile_id ou la @profile_name .
[ @profile_name = ] 'profile_name'
Nom du profil à supprimer. @profile_name est sysname, avec la valeur par défaut NULL
. Vous pouvez spécifier la @profile_id ou la @profile_name .
[ @account_id = ] account_id
ID du compte à supprimer. @account_id est int, avec la valeur par défaut NULL
. La @account_id ou la @account_name peuvent être spécifiées.
[ @account_name = ] 'account_name'
Nom du compte à supprimer. @account_name est sysname, avec la valeur par défaut NULL
. La @account_id ou la @account_name peuvent être spécifiées.
Valeurs des codes de retour
0
(réussite) or 1
(échec).
Jeu de résultats
Aucune.
Notes
Retourne 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, si vous préparez à arrêter un serveur SMTP existant, vous supprimez les comptes qui utilisent ce serveur SMTP de tous les profils, plutôt que 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, si vous modifiez les serveurs SMTP qu’un profil utilise, il peut être pratique de supprimer tous les comptes du profil, puis d’ajouter de nouveaux comptes si nécessaire.
La procédure sysmail_delete_profileaccount_sp
stockée se trouve dans la msdb
base de données 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
Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE
des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.
Exemples
L'exemple suivant montre la suppression du compte Audit Account
du profil AdventureWorks Administrator
.
EXEC msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account';