sysmail_add_profile_sp (Transact-SQL)

sysmail_add_profile_sp (Transact-SQL)

Crée un nouveau profil de messagerie de base de données.

RemarqueRemarque

Comme la messagerie de base de données n'utilise pas l'interface MAPI (Messaging Application Programming Interface), ses profils ne sont pas des profils de messagerie MAPI. La messagerie de base de données n'utilise pas les profils SQL Mail.

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


sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] 'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]

[ @profile_name = ] 'profile_name'

Nom du nouveau profil. L'argument profile_name est de type sysname et n'a pas de valeur par défaut.

[ @description = ] 'description'

Description optionnelle du nouveau profil. L'argument description est de type nvarchar(256) et n'a pas de valeur par défaut.

[ @profile_id = ] new_profile_idOUTPUT

Retourne l'ID du nouveau profil. L'argument new_profile_id est de type int, avec NULL comme valeur par défaut.

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

Un profil de messagerie de base de données contient un nombre quelconque de comptes de messagerie de base de données. Les procédures stockées de la messagerie de base de données peuvent faire référence à un profil par son nom ou par l'ID généré par cette procédure. Pour plus d'informations sur l'ajout d'un compte à un profil, consultez sysmail_add_profileaccount_sp (Transact-SQL).

Le nom et la description du profil peuvent être modifiés à l'aide de la procédure stockée sysmail_update_profile_sp, tandis que son ID reste constant pendant la durée de vie du profil.

Le nom du profil doit être unique pour le moteur de base de données SQL Server 2005, sans quoi la procédure stockée retourne une erreur.

La procédure stockée sysmail_add_profile_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.

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

A. Création d'un profil

L'exemple ci-dessous crée un profil de messagerie de base de données nommé AdventureWorks2008R2 Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks2008R2 Administrator',
       @description = 'Profile used for administrative mail.' ;

B. Création d'un profil et enregistrement de son ID dans une variable

L'exemple ci-dessous crée un profil de messagerie de base de données nommé AdventureWorks Administrator. L'exemple stocke l'ID du profil dans la variable @profileId et retourne un jeu de résultats contenant l'ID du nouveau profil.

DECLARE @profileId INT ;

EXECUTE msdb.dbo.sysmail_add_profile_sp
       @profile_name = 'AdventureWorks2008R2 Administrator',
       @description = 'Profile used for administrative mail.',
       @profile_id = @profileId OUTPUT ;

SELECT @profileId ;

Ajouts de la communauté

AJOUTER
Afficher:
© 2016 Microsoft