共用方式為

sp_update_proxy (Transact-SQL)

  • 發行項

變更現有 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

請參閱

參考

SQL Server Agent 預存程序 (Transact-SQL)

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)

sp_grant_login_to_proxy (Transact-SQL)

sp_revoke_login_from_proxy (Transact-SQL)

概念

實作 SQL Server Agent 安全性