sp_update_proxy (Transact-SQL)
變更現有 Proxy 的屬性。
語法
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 之 Proxy 識別碼。proxy_id 是 int，預設值是 NULL。
[ @proxy_name= ] 'proxy_name'
要變更的 Proxy 名稱。proxy_name 是 sysname，預設值是 NULL。
[ @credential_name = ] 'credential_name'
Proxy 新認證的名稱。credential_name 是 sysname，預設值是 NULL。您只能指定 credential_name 或 credential_id 其中之一。
[ @credential_id = ] credential_id
Proxy 新認證的識別碼。credential_id 是 int，預設值是 NULL。您只能指定 credential_name 或 credential_id 其中之一。
[ @new_name= ] 'new_name'
Proxy 的新名稱。new_name 是 sysname，預設值是 NULL。當提供這個引數時，程序會將 Proxy 的名稱改成 new_name。當這個引數是 NULL 時，Proxy 的名稱會維持不變。
[ @enabled = ] is_enabled
這是指是否啟用 Proxy。is_enabled 旗標是 tinyint，預設值是 NULL。當 is_enabled 是 0 時，不會啟用 Proxy，作業步驟無法使用它。當這個引數是 NULL 時，Proxy 的狀態會維持不變。
[ @description = ] 'description'
Proxy 的新描述。description 是 nvarchar(512)，預設值是 NULL。當這個引數是 NULL 時，Proxy 的描述會維持不變。
傳回碼值
0 (成功) 或 1 (失敗)
備註
您必須指定 @proxy_name 或 @proxy_id。如果同時指定了兩個引數，這兩個引數都必須參考相同的 Proxy，否則，預存程序會失敗。
您必須指定 @credential_name 或 @credential_id，才能變更 Proxy 的認證。如果同時指定了兩個引數，這兩個引數必須參考相同的認證，否則，預存程序會失敗。
這個程序會變更 Proxy，但不會變更 Proxy 的存取權。若要變更 Proxy 的存取權，請使用 sp_grant_login_to_proxy 和 sp_revoke_login_from_proxy。
權限
只有系統管理員 (sysadmin) 固定安全性角色的成員，才能夠執行這個程序。
範例
下列範例會將 Catalog application proxy Proxy 的 enabled 值設為 0。
USE msdb ;
GO
EXEC dbo.sp_update_proxy
@proxy_name = 'Catalog application proxy',
@enabled = 0;
GO
請參閱
參考
sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL)
sp_grant_login_to_proxy (Transact-SQL)
sp_revoke_login_from_proxy (Transact-SQL)