다음을 통해 공유


sp_update_proxy(Transact-SQL)

기존 프록시의 속성을 변경합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

sp_update_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name',
    [ @credential_name = ] 'credential_name' ,
    [ @credential_id = ] credential_id ,
    [ @new_name = ] 'new_name' ,
    [ @enabled = ] is_enabled ,
    [ @description = ] 'description'

인수

  • [ @proxy_id= ] id
    변경할 프록시의 프록시 ID입니다. proxy_id는 int이며 기본값은 NULL입니다.

  • [ @proxy_name= ] 'proxy_name'
    변경할 프록시의 이름입니다. proxy_name은 sysname이며 기본값은 NULL입니다.

  • [ @credential_name = ] 'credential_name'
    프록시에 대한 새 자격 증명의 이름입니다. credential_name은 sysname이며 기본값은 NULL입니다. credential_name 또는 credential_id를 지정할 수 있습니다.

  • [ @credential_id = ] credential_id
    프록시에 대한 새 자격 증명의 ID입니다. credential_id는 int이며 기본값은 NULL입니다. credential_name 또는 credential_id를 지정할 수 있습니다.

  • [ @new_name= ] 'new_name'
    프록시의 새 이름입니다. new_name은 sysname이며 기본값은 NULL입니다. 값을 지정하면 프로시저에서 프록시의 이름을 new_name으로 변경합니다. 이 인수가 NULL이면 프록시의 이름은 변경되지 않은 상태로 유지됩니다.

  • [ @enabled = ] is_enabled
    프록시 설정 여부입니다. is_enabled 플래그는 tinyint이며 기본값은 NULL입니다. is_enabled가 0이면 프록시가 설정되지 않아 작업 단계에서 사용할 수 없습니다. 이 인수가 NULL이면 프록시의 상태는 변경되지 않은 상태로 유지됩니다.

  • [ @description= ] 'description'
    프록시에 대한 새로운 설명입니다. description은 nvarchar(512)이며 기본값은 NULL입니다. 이 인수가 NULL이면 프록시에 대한 설명은 변경되지 않은 상태로 유지됩니다.

반환 코드 값

0(성공) 또는 1(실패)

주의

@proxy_name 또는 @proxy_id를 지정해야 합니다. 두 인수가 모두 지정될 경우 두 인수는 같은 프록시를 참조해야 합니다. 그렇지 않으면 저장 프로시저가 실패합니다.

프록시에 대한 자격 증명을 변경하려면 @credential_name이나 @credential_id를 지정해야 합니다. 두 인수를 모두 지정하면 두 인수는 같은 자격 증명을 참조해야 합니다. 그렇지 않으면 저장 프로시저가 실패합니다.

이 프로시저는 프록시를 변경하지만 프록시에 대한 액세스 권한은 변경하지 않습니다. 프록시에 대한 액세스 권한을 변경하려면 sp_grant_login_to_proxysp_revoke_login_from_proxy를 사용합니다.

사용 권한

sysadmin 고정 보안 역할의 멤버만 이 프로시저를 실행할 수 있습니다.

다음 예에서는 프록시 Catalog application proxy에 설정된 값을 0으로 설정합니다.

USE msdb ;
GO

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