次の方法で共有

sp_update_proxy (Transact-SQL)

  • [アーティクル]

適用対象: SQL サーバー

既存のプロキシのプロパティを変更します。

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

変更するプロキシのプロキシ 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

プロキシが有効かどうかを指定します。 @enabled は tinyint で、既定値は NULL です。 @enabledが0されている場合、プロキシは有効ではなく、ジョブ ステップでは使用できません。 この引数が NULLされている場合、プロキシの状態は変更されません。

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

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

関連するコンテンツ