Поделиться через


sysmail_update_profile_sp (Transact-SQL)

Область применения: SQL Server

Изменяет описание или имя профиля компонента Database Mail.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @profile_id = ] profile_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 (сбой).

Замечания

При указании идентификатора профиля и имени профиля процедура изменяет имя профиля на указанное имя и обновляет описание профиля. Если указан только один из этих аргументов, то процедура обновляет описание профиля.

Хранимая процедура sysmail_update_profile_sp находится в msdb базе данных и принадлежит схеме dbo . Процедура должна выполняться с трехкомпонентным именем, если текущая база данных не msdbявляется.

Разрешения

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

А. Изменение описания профиля

В следующем примере изменяется описание профиля, именованного AdventureWorks Administrator в msdb базе данных.

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

B. Изменение имени и описания профиля

В следующем примере изменяется имя и описание профиля с идентификатором 750профиля.

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