Compartilhar via


sysmail_update_profile_sp (Transact-SQL)

Altera a descrição ou o nome de um perfil do Database Mail.

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

Sintaxe

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]

Argumentos

  • [ @profile_id = ] profile_id
    A ID de perfil a ser atualizada. profile_id é int, com um padrão NULL. Pelo menos uma profile_id ou um profile_name deve ser especificado. Se ambos forem especificados, o procedimento alterará o nome do perfil.

  • [ @profile_name = ] 'profile_name'
    O nome do perfil a ser atualizado ou o novo nome para o perfil. profile_name é sysname, com um padrão NULL. Pelo menos uma profile_id ou um profile_name deve ser especificado. Se ambos forem especificados, o procedimento alterará o nome do perfil.

  • [ @description = ] 'description'
    A nova descrição para o perfil. description é nvarchar(256), com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

Quando a ID de perfil e o nome de perfil são especificados, o procedimento altera o nome do perfil para o nome fornecido e atualiza a descrição para o perfil. Quando somente um desses argumentos é fornecido, o procedimento atualiza a descrição para o perfil.

O procedimento armazenado sysmail_update_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. Alterando a descrição de um perfil

O exemplo a seguir altera a descrição para o perfil nomeado AdventureWorks Administrator no banco de dados msdb.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator'
    ,@description = 'Administrative mail profile.';

B. Alterando o nome e a descrição de um perfil

O exemplo a seguir altera o nome e a descrição do perfil com a ID de perfil 750.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750
    ,@profile_name = 'Operator'
    ,@description = 'Profile to send alert e-mail to operators.';