Partager via


sysmail_update_principalprofile_sp (Transact-SQL)

Met à jour les informations d'une association entre un principal et un profil.

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)

Concepts

Messagerie de base de données

Objets de configuration de la messagerie de base de données