Partager 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) or 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

Vous pouvez accorder EXECUTE des autorisations sur cette procédure, 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.';