sysmail_delete_profileaccount_sp (Transact-SQL)
Удаляет учетную запись из профиля компонента Database Mail.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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 и SQL Mail (Transact-SQL)
Другие ресурсы
Компонент Database Mail
Выбор задачи конфигурации (компонент Database Mail)
Учетные записи компонента Database Mail
Профили Database Mail