sp_update_proxy (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 之 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

請參閱

參考

概念