sysmail_update_principalprofile_sp (Transact-SQL)
Met à jour les informations d'une association entre un principal et un profil.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de Transact-SQL
Syntaxe
sysmail_update_principalprofile_sp { @principal_id = principal_id | @principal_name = 'principal_name' } ,
{ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
[ @is_default = ] 'is_default'
Arguments
[ @principal_id = ] principal_id
ID de l'utilisateur ou du rôle de base de données dans la base de données msdb pour l'association à modifier. principal_id est de type int, avec NULL comme valeur par défaut. principal_id ou principal_name doit être spécifié.[ @principal_name = ] 'principal_name'
Nom de l'utilisateur ou du rôle de base de données dans la base de données msdb pour l'association à mettre à jour. principal_name est de type sysname, avec NULL comme valeur par défaut. principal_id ou principal_name peut être spécifié.[ @profile_id = ] profile_id
Identificateur du profil pour l'association à modifier. profile_id est de type int, avec NULL comme valeur par défaut. profile_id ou profile_name doit être spécifié.[ @profile_name = ] 'profile_name'
Nom du profil pour l'association à modifier. profile_name est de type sysname, avec NULL comme valeur par défaut. profile_id ou profile_name doit être spécifié.[ @is_default = ] 'is_default'
Indique si ce profil représente le profil par défaut pour l'utilisateur de la base de données. Un utilisateur de base de données ne peut avoir plus d'un seul profil par défaut. is_default est de type bit et n'a pas de valeur par défaut.
Valeurs du code de retour
0 (succès) ou 1 (échec)
Jeux de résultats
Aucun
Notes
Cette procédure stockée est modifiée si le profil spécifié est ou non le profil par défaut pour l'utilisateur de la base de données. Un utilisateur de base de données peut avoir uniquement un profil privé par défaut.
Lorsque le nom du principal pour l'association est public ou lorsque l'ID de l'association est 0, cette procédure stockée modifie le profil public. Il ne peut y avoir qu'un seul profil public par défaut.
Lorsque @is_default vaut « 1 » et que le principal est associé à plusieurs profils, le profil spécifié devient le profil par défaut du principal. Le précédent profil par défaut est toujours associé au principal, mais il ne représente plus le profil par défaut.
La procédure stockée sysmail_update_principalprofile_sp est dans la base de données msdb et est possédée par le schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données active n'est pas msdb.
Autorisations
Les autorisations d'exécution de cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.
Exemples
A. Définition du profil public par défaut d'une base de données
L'exemple suivant définit le profil General Use Profile comme profil public par défaut pour les utilisateurs de la base de données msdb.
EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
@principal_name = 'public',
@profile_name = 'General Use Profile',
@is_default = '1';
B. Définition du profil privé par défaut d'un utilisateur
L'exemple suivant définit le profil AdventureWorks Administrator comme profil par défaut du principal ApplicationUser de la base de données msdb. Le profil doit déjà être associé au principal. Le précédent profil par défaut est toujours associé au principal, mais il ne représente plus le profil par défaut.
EXECUTE msdb.dbo.sysmail_update_principalprofile_sp
@principal_name = 'ApplicationUser',
@profile_name = 'AdventureWorks Administrator',
@is_default = '1' ;
Voir aussi
Référence
Procédures stockées de messagerie de base de données (Transact-SQL)