sysmail_update_principalprofile_sp (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 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 AdventureWorks2008R2 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 = 'AdventureWorks2008R2 Administrator',
    @is_default = '1' ;

Voir aussi

Référence

Concepts