sp_update_proxy (Transact-SQL)
適用対象: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 = ] 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
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示