Partager via


sysmail_update_principalprofile_sp (Transact-SQL)

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

Icône Lien de rubriqueConventions 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 du rôle ou de l'utilisateur de base de données dans la base de données msdb pour l'association à modifier. L'argument 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 du rôle ou de l'utilisateur de base de données dans la base de données msdb pour l'association à mettre à jour. L'argument 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. L'argument 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. L'argument 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 peut avoir uniquement un profil par défaut. L'argument is_default est de type bit, sans 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 serveur 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 serveur principal est associé à plusieurs profils, le profil spécifié devient le profil par défaut du serveur principal. Le précédent profil par défaut est toujours associé au serveur 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. 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

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 serveur principal ApplicationUser de la base de données msdb. Le profil doit déjà être associé au serveur principal. Le précédent profil par défaut est toujours associé au serveur 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' ;