Compartilhar via


sysmail_add_profile_sp (Transact-SQL)

Cria um novo perfil do Database Mail.

ObservaçãoObservação

Como o Database Mail não usa a interface MAPI (Messaging Application Programming Interface), seus perfis não são perfis de email MAPI. O Database Mail não usa perfil do SQL Mail.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @profile_name = ] 'profile_name'
    O nome para o novo perfil. profile_name é sysname, sem nenhum padrão.

  • [ @description = ] 'description'
    A descrição opcional para o novo perfil. description é nvarchar(256), sem nenhum padrão.

  • [ @profile_id = ] new_profile_idOUTPUT
    Retorna a ID para o novo perfil. new_profile_id é int, com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

Um perfil Database Mail contém qualquer número de contas do Database Mail. Os procedimentos armazenados do Database Mail podem se referir a um perfil por meio do nome do perfil ou da identificação do perfil gerada por este procedimento. Para obter mais informações sobre como adicionar uma conta a um perfil, consulte sysmail_add_profileaccount_sp (Transact-SQL).

O nome e a descrição do perfil podem ser alterados com o procedimento armazenado sysmail_update_profile_sp, enquanto que a identificação do perfil permanece constante durante sua existência.

O nome de perfil deve ser exclusivo para o Microsoft Mecanismo de banco de dados do SQL Server, caso contrário o procedimento armazenado retornará um erro.

O procedimento armazenado sysmail_add_profile_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

A. Criando um novo perfil

O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks2008R2 Administrator.

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

B. Criando um novo perfil, salvando a identificação do perfil em uma variável

O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks Administrator. O exemplo armazena o número da identificação do perfil na variável @profileId e retorna um conjunto de resultados contendo o número de identificação do perfil para o novo perfil.

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 ;