sysmail_update_profile_sp (Transact-SQL)

适用于SQL Server

更改数据库邮件配置文件的说明或名称。

Transact-SQL 语法约定

语法

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

参数

[ @profile_id = ] profile_id

要更新的配置文件 ID。 @profile_id为 int,默认值为 NULL. 必须至少指定一个 @profile_id@profile_name 。 如果同时指定二者,则过程将更改配置文件的名称。

[ @profile_name = ] 'profile_name'

要更新的配置文件名称或配置文件的新的名称。 @profile_name为 sysname,默认值为 NULL. 必须至少指定一个 @profile_id@profile_name 。 如果同时指定二者,则过程将更改配置文件的名称。

[ @description = ] 'description'

对配置文件的新的说明。 @description为 nvarchar(256),默认值为 NULL.

返回代码值

0(成功)或 1(失败)。

注解

当同时指定配置文件 ID 和配置文件名称时,该过程会将配置文件的名称更改为提供的名称,并更新配置文件的说明。 当只提供其中的一个参数时,该过程会更新配置文件的说明。

存储过程 sysmail_update_profile_sp 位于 msdb 数据库中,由 dbo 架构拥有。 如果当前数据库不是 msdb,则必须使用三部分名称执行该过程。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

示例

A. 更改配置文件的说明

以下示例更改数据库中命名 AdventureWorks Administratormsdb 配置文件的说明。

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

B. 更改配置文件的名称和说明

以下示例使用配置文件 ID 750更改配置文件的名称和说明。

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