sp_update_proxy(Transact-SQL)
기존 프록시의 속성을 변경합니다.
.gif "항목 링크 아이콘")
구문
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_proxy 및 sp_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
참고 항목
참조
SQL Server 에이전트 저장 프로시저(Transact-SQL)
sp_grant_login_to_proxy(Transact-SQL)
sp_revoke_login_from_proxy(Transact-SQL)