Partage via


sysmail_update_profile_sp (Transact-SQL)

S'applique à : SQL Server

Modifie la description ou le nom d'un profil de messagerie de base de données.

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]
[ ; ]

Arguments

[ @profile_id = ] profile_id

ID de profil à mettre à jour. @profile_id est int, avec la valeur par défaut NULL. Au moins un des @profile_id ou @profile_name doit être spécifié. Si les deux arguments sont indiqués, la procédure modifie le nom du profil.

[ @profile_name = ] 'profile_name'

Nom du profil à mettre à jour ou nouveau nom pour le profil. @profile_name est sysname, avec la valeur par défaut NULL. Au moins un des @profile_id ou @profile_name doit être spécifié. Si les deux arguments sont indiqués, la procédure modifie le nom du profil.

[ @description = ] 'description'

Nouvelle description du profil. @description est nvarchar(256), avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

Lorsque l’ID de profil et le nom du profil sont spécifiés, la procédure remplace le nom du profil par le nom fourni et met à jour la description du profil. Lorsqu'un seul de ces arguments est indiqué, la procédure met simplement à jour la description du profil.

La procédure sysmail_update_profile_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

R. Modifier la description d’un profil

L’exemple suivant modifie la description du profil nommé AdventureWorks Administrator dans la msdb base de données.

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Administrative mail profile.';

B. Modifier le nom et la description d’un profil

L’exemple suivant modifie le nom et la description du profil avec l’ID 750de profil.

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750,
    @profile_name = 'Operator',
    @description = 'Profile to send alert e-mail to operators.';