Share via

sysmail_delete_profileaccount_sp (Transact-SQL)

  • Article

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. Les @profile_id ou les @profile_name peuvent être spécifiés.

[ @profile_name = ] 'profile_name'

Nom du profil à supprimer. @profile_name est sysname, avec la valeur par défaut NULL. Les @profile_id ou les @profile_name peuvent être spécifiés.

[ @account_id = ] account_id

ID du compte à supprimer. @account_id est int, avec la valeur par défaut NULL. Le @account_id ou le @account_name peut être spécifié.

[ @account_name = ] 'account_name'

Nom du compte à supprimer. @account_name est sysname, avec la valeur par défaut NULL. Le @account_id ou le @account_name peut être spécifié.

Valeurs des codes de retour

0 (réussite) ou 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';

Contenu connexe