適用対象:
SQL Server
既存のプロキシのプロパティを変更します。
構文
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
変更するプロキシのプロキシ ID 番号。
@proxy_id は int で、既定値は NULL です。
[ @proxy_name = ] N'proxy_name
変更するプロキシの名前。
@proxy_name は sysname で、既定値は NULL です。
[ @credential_name = ] N'credential_name'
プロキシの新しい資格情報の名前。
@credential_name は sysname で、既定値は NULL です。
@credential_nameまたは@credential_idを指定する必要があります。
[ @credential_id = ] credential_id
プロキシの新しい資格情報の識別番号を指定します。
@credential_id は int で、既定値は NULL です。
@credential_nameまたは@credential_idを指定する必要があります。
[ @new_name = ] N'new_name'
プロキシの新しい名前。
@new_name は sysname で、既定値は NULL です。 指定すると、プロキシの名前が @new_nameに変更されます。 この引数を NULLすると、プロキシの名前は変更されません。
[ @enabled = ] 有効
プロキシが有効かどうかを指定します。
@enabled は tinyint で、既定値は NULL です。
@enabledが0されている場合、プロキシは有効ではなく、ジョブ ステップでは使用できません。 この引数が NULLされている場合、プロキシの状態は変更されません。
[ @description = ] 説明
プロキシの新しい説明を指定します。
@description は nvarchar(512) で、既定値は NULL です。 この引数を NULLすると、プロキシの説明は変更されません。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
@proxy_nameまたは@proxy_idを指定する必要があります。 両方の引数を指定する場合は、両方とも同じプロキシを参照する必要があります。異なるプロキシを参照する場合、ストアド プロシージャは失敗します。
プロキシの資格情報を変更するには、 @credential_name または @credential_id を指定する必要があります。 両方の引数を指定する場合は、両方とも同じ資格情報を参照する必要があります。異なる資格情報を参照する場合、ストアド プロシージャは失敗します。
この手順ではプロキシを変更しますが、プロキシへのアクセスは変更しません。 プロキシへのアクセスを変更するには、 sp_grant_login_to_proxy と sp_revoke_login_from_proxyを使用します。
アクセス許可
このプロシージャを実行できるのは、固定セキュリティ ロール sysadmin のメンバーだけです。
例
次の例では、プロキシ Catalog application proxy の enabled の値を 0 に設定します。
USE msdb;
GO
EXECUTE dbo.sp_update_proxy
@proxy_name = 'Catalog application proxy',
@enabled = 0;
GO