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


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является.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить 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.';