sysmail_delete_profileaccount_sp (Transact-SQL)

Статья
06/18/2013

Удаляет учетную запись из профиля компонента Database Mail.

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

sysmail_delete_profileaccount_sp  {   [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    {   [ @account_id = ] account_id | [ @account_name = ] 'account_name' }

Аргументы

[ @profile_id = ] profile_id
Идентификатор удаляемого профиля. Аргумент profile_id имеет тип int и значение по умолчанию NULL. Можно указать либо аргумент profile_id, либо аргумент profile_name.
[ @profile_name = ] 'profile_name'
Имя удаляемого профиля. Аргумент profile_name имеет тип sysname и значение по умолчанию NULL. Можно указать либо аргумент profile_id, либо аргумент profile_name.
[ @account_id = ] account_id
Идентификатор удаляемой учетной записи. Аргумент account_id имеет тип int и значение по умолчанию NULL. Можно указать либо аргумент account_id, либо аргумент account_name.
[ @account_name = ] 'account_name'
Имя удаляемой учетной записи. Аргумент account_name имеет тип sysname и значение по умолчанию NULL. Можно указать либо аргумент account_id, либо аргумент account_name.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

Возвращает ошибку, если указанная учетная запись не связана с указанным профилем.

Если указана учетная запись, но не указан профиль, хранимая процедура удаляет указанную учетную запись из всех профилей. Например, если предстоит отключить существующий SMTP-сервер, то следует удалить учетные записи, в которых используется этот SMTP-сервер, из всех профилей, вместо того чтобы удалять каждую учетную запись из каждого профиля.

Если указан профиль, но не указана учетная запись, хранимая процедура удаляет все учетные записи из указанного профиля. Например, если изменены используемые профилем SMTP-серверы, то может оказаться удобнее удалить все учетные записи из профиля, а затем добавлять новые учетные записи по мере необходимости.

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

Разрешения

Разрешения на выполнение этой процедуры по умолчанию принадлежат членам предопределенной роли сервера sysadmin.

Примеры

В следующем примере показано удаление учетной записи Audit Account из профиля AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account' ;

См. также

Справочник

Хранимые процедуры Database Mail (Transact-SQL)

Основные понятия

Компонент Database Mail

Создание учетной записи компонента Database Mail

Объекты конфигурации компонента Database Mail

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