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

  • Статья

sysmail_delete_profileaccount_sp (Transact-SQL)

Удаляет учетную запись из профиля компонента 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' ;