sysmail_delete_profileaccount_sp (Transact-SQL)

  • Статья

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

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

Разрешения

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

Примеры

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

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

Связанный контент