分享方式:


sp_update_proxy (Transact-SQL)

適用於:SQL Server

變更現有 Proxy 的屬性。

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 的 Proxy 識別碼。 @proxy_id為 int,預設值為 NULL

[ @proxy_name = ] N'proxy_name'

要變更的 Proxy 名稱。 @proxy_name為 sysname,預設值為 NULL

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

Proxy 的新名稱。 @new_name為 sysname,預設值為 NULL。 提供時,程式會將 Proxy 的名稱變更為 @new_name。 當這個自變數為 NULL時,Proxy 的名稱會保持不變。

[ @enabled = ] enabled

指定是否啟用 Proxy。 @enabled為 tinyint,預設值為 NULL。 當 @enabled0,不會啟用 Proxy,且無法由作業步驟使用。 當這個自變數為 NULL時,Proxy 的狀態會保持不變。

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

權限

只有系統管理員固定安全性角色的成員才能執行此程式。

範例

下列範例會將 Proxy Catalog application proxy 的啟用值設定為 0

USE msdb;
GO

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