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.';