Share via

  • Статья

sp_update_proxy (Transact-SQL)

Изменяет свойства существующей учетной записи-посредника.

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

Синтаксис

sp_update_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name',
    [ @credential_name = ] 'credential_name' ,
    [ @credential_id = ] credential_id ,
    [ @new_name = ] 'new_name' ,
    [ @enabled = ] is_enabled ,
    [ @description = ] 'description'

Аргументы

  • [ @proxy_id= ] id
    Идентификационный номер изменяемой учетной записи-посредника. Аргумент proxy_id имеет тип int и значение по умолчанию NULL.

  • [ @proxy_name= ] 'proxy_name'
    Имя изменяемой учетной записи-посредника. Аргумент proxy_name имеет тип sysname и значение по умолчанию NULL.

  • [ @credential_name = ] 'credential_name'
    Имя новых учетных данных для учетной записи-посредника. Аргумент credential_name имеет тип sysname и значение по умолчанию NULL. Может быть указан аргумент credential_name или аргумент credential_id.

  • [ @credential_id = ] credential_id
    Идентификационный номер новых учетных данных для учетной записи-посредника. Аргумент credential_id имеет тип int и значение по умолчанию NULL. Может быть указан аргумент credential_name или аргумент credential_id.

  • [ @new_name= ] 'new_name'
    Новое имя учетной записи-посредника. Аргумент new_name имеет тип sysname и значение по умолчанию NULL. Если этот аргумент указан, процедура меняет имя учетной записи-посредника на new_name. Если этот аргумент равен NULL, имя учетной записи-посредника остается неизменным.

  • [ @enabled = ] is_enabled
    Разрешена ли учетная запись-посредник. Аргумент is_enabled имеет тип tinyint и значение по умолчанию NULL. Если аргумент is_enabled принимает значение 0, учетная запись-посредник не разрешена и использоваться шагом задания не может. Если этот аргумент равен NULL, состояние учетной записи-посредника остается неизменным.

  • [ @description= ] 'description'
    Новое описание учетной записи-посредника. Аргумент description имеет тип nvarchar(512) и значение по умолчанию NULL. Если этот аргумент равен NULL, описание учетной записи-посредника остается неизменным.

Возвращаемые кодовые значения

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

Замечания

Должен быть указан либо аргумент @proxy_name, либо аргумент @proxy_id. Если указаны оба аргумента, они должны ссылаться на одну и ту же учетную запись-посредник, в противном случае хранимая процедура завершается ошибкой.

Для изменения учетных данных учетной записи-посредника должен быть указан либо аргумент @credential_name, либо аргумент @credential_id. Если указаны оба аргумента, они должны ссылаться на одни и те же учетные данные, в противном случае хранимая процедура завершается ошибкой.

Эта процедура вносит изменения в учетную запись-посредник, но не меняет порядок доступа к нему. Для изменения доступа к учетной записи-посреднику пользуйтесь хранимыми процедурами sp_grant_login_to_proxy и sp_revoke_login_from_proxy.

Разрешения

Только члены фиксированной роли безопасности sysadmin могут выполнять эту процедуру.

Примеры

В следующем примере значение «enabled» для учетной записи-посредника Catalog application proxy устанавливается в 0.

USE msdb ;
GO

EXEC dbo.sp_update_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 0;
GO