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

sp_update_proxy (Transact-SQL)

  • Статья

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

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_update_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @credential_name = ] N'credential_name' ]
    [ , [ @credential_id = ] credential_id ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
[ ; ]

Аргументы

[ @proxy_id = ] proxy_id

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

[ @proxy_name = ] N'proxy_name'

Имя изменяемой учетной записи-посредника. @proxy_name — sysname с значением по умолчаниюNULL.

[ @credential_name = ] N'credential_name'

Имя новых учетных данных для учетной записи-посредника. @credential_name — sysname с значением по умолчаниюNULL. Необходимо указать либо @credential_name, либо @credential_id.

[ @credential_id = ] credential_id

Идентификационный номер новых учетных данных для учетной записи-посредника. @credential_id имеет значение int с значением по умолчаниюNULL. Необходимо указать либо @credential_name, либо @credential_id.

[ @new_name = ] N'new_name'

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

[ @enabled = ] включен

Указывает, включена ли учетная запись-посредник. @enabled крошечный, с значением по умолчаниюNULL. Если @enabled , 0прокси-сервер не включен и не может использоваться на шаге задания. Если этот аргумент имеет значение NULL, состояние прокси-сервера остается неизменным.

[ @description = ] N'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

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