sysmail_add_principalprofile_sp (Transact-SQL)

Article
12/15/2008

Mis à jour : 12 décembre 2006

Accorde l'autorisation d'utilisation d'un profil de messagerie de base de données à un utilisateur de base de données msdb ou à un rôle de base de données public.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sysmail_add_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
Correspond à l'ID de l'utilisateur de base de données dans la base de données msdb ou 0 pour pour le rôle public. L'argument principal_id est de type int avec NULL comme valeur par défaut. principal_id ou principal_name doit être spécifié. Si principal_id a la valeur 0, le profil est public, accordant ainsi l'accès à tous les serveurs principaux de la base de données.

[ @principal_name = ] 'principal_name'
Correspond au nom de l'utilisateur de base de données dans la base de données msdb ou 'public' pour pour le rôle public. L'argument principal_name est de type sysname avec NULL comme valeur par défaut. principal_id ou principal_name doit être spécifié. Si principal_name a la valeur 'public', le profil est public, accordant ainsi l'accès à tous les serveurs principaux de la base de données.

[ @profile_id = ] profile_id
Identificateur du profil pour l'association. 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. L'argument profile_name est de type sysname et n'a pas de 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 le serveur principal. Un serveur principal ne peut avoir qu'un seul profil par défaut. L'argument is_default est de type bit et n'a pas de valeur par défaut.

Notes

Pour rendre un profil public, spécifiez un @principal_id de 0 ou donnez à l'argument @principal_name la valeur public. Un profil public est disponible pour tous les utilisateurs dans la base de données msdb, mais ces utilisateurs doivent être membres de DatabaseMailUserRole pour exécuter la procédure sp_send_dbmail.

Un utilisateur de base de données ne peut avoir plus d'un seul profil par défaut. Lorsque @is_default a la valeur 1 et que l'utilisateur est déjà associé à un ou plusieurs profils, le profil spécifié devient le profil par défaut de l'utilisateur. L'ancien profil par défaut est toujours associé à l'utilisateur, mais n'est plus le profil par défaut.

Lorsque @is_default a la valeur 0 et qu'il n'existe aucune autre association, la procédure stockée renvoie une erreur.

La procédure stockée sysmail_add_principalprofile_sp se trouve dans la base de données msdb 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

Les autorisations d'exécution de cette procédure sont accordées par défaut aux membres du rôle de serveur fixe sysadmin.

Valeurs du code de retour

0 (succès) ou 1 (échec)

Exemples

A. Création d'une association et définition du profil par défaut

L'exemple suivant crée une association entre le profil appelé AdventureWorks Administrator Profile et l'utilisateur ApplicationUser de la base de données msdb. Le profil est le profil par défaut de l'utilisateur.

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator Profile',
    @is_default = 1 ;

B. Modification d'un profil en profil public par défaut

L'exemple suivant fait du profil AdventureWorks Public Profile le profil public par défaut des utilisateurs de la base de données msdb.

EXECUTE msdb.dbo.sysmail_add_principalprofile_sp
    @principal_name = 'public',
    @profile_name = 'AdventureWorks Public Profile',
    @is_default = 1 ;

Voir aussi

Historique des modifications

Version	Historique
12 décembre 2006	Contenu modifié : Définition des utilisateurs en tant qu'utilisateurs msdb. Ce rôle est limité au rôle public.

Partager via