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。 當 @enabled 為 0時，不會啟用 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_proxy 和 sp_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

相關內容