sysmail_update_profile_sp (Transact-SQL)

Aplica-se a: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@profile_id [ = ] profile_id

A ID do perfil a ser atualizada. @profile_id é int, com um padrão de NULL. Pelo menos um dos @profile_id ou @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 de NULL. Pelo menos um dos @profile_id ou @profile_name deve ser especificado. Se ambos forem especificados, o procedimento alterará o nome do perfil.

@description [ = ] 'descrição'

A nova descrição do perfil. @description é nvarchar(256), com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

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

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

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

R. Alterar a descrição de um perfil

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

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

B. Alterar 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 750do perfil.

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