sp_help_proxy(Transact-SQL)

적용 대상:SQL Server

하나 이상의 프록시에 대한 정보를 나열합니다.

Transact-SQL 구문 표기 규칙

구문

  
sp_help_proxy   
    [ @proxy_id = ] id,  
    [ @proxy_name = ] 'proxy_name' ,  
    [ @subsystem_name = ] 'subsystem_name' ,  
    [ @name = ] 'name'  

인수

[ @proxy_id = ] id 정보를 나열할 프록시의 프록시 ID 번호입니다. proxy_id int이며 기본값은 NULL입니다. ID 또는 proxy_name 지정할 수 있습니다.

[ @proxy_name = ] 'proxy_name' 정보를 나열할 프록시의 이름입니다. proxy_name sysname이며 기본값은 NULL입니다. ID 또는 proxy_name 지정할 수 있습니다.

[ @subsystem_name = ] 'subsystem_name' 프록시를 나열할 하위 시스템의 이름입니다. subsystem_name sysname이며 기본값은 NULL입니다. subsystem_name 지정되면 이름도 지정해야 합니다.

다음 표에서는 각 하위 시스템에 대한 값을 나열합니다.

값	설명
ActiveScripting	ActiveX 스크립트
CmdExec	운영 체제(CmdExec)
Snapshot	Replication Snapshot Agent
LogReader	복제 로그 판독기 에이전트
배포	Replication Distribution Agent
병합	Replication Merge Agent
QueueReader	Replication Queue Reader Agent
ANALYSISQUERY	Analysis Services 명령
ANALYSISCOMMAND	Analysis Services 쿼리
Dts	SSIS 패키지 실행
PowerShell	PowerShell 스크립트

[ @name = ] 'name' 프록시를 나열할 SQL Server 로그인의 이름입니다. 이름은 nvarchar(256)이며 기본값은 NULL입니다. 이름을 지정하면 subsystem_name 지정해야 합니다.

반환 코드 값

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

결과 집합

열 이름	데이터 형식	설명
proxy_id	int	프록시 ID 번호입니다.
이름	sysname	프록시의 이름입니다.
credential_identity	sysname	프록시와 연결된 자격 증명의 Microsoft Windows 도메인 이름 및 사용자 이름입니다.
사용	tinyint	이 프록시를 사용할 수 있는지 여부입니다. { 0 = 사용 안 함, 1 = enabled }
description	nvarchar(1024)	이 프록시에 대한 설명입니다.
user_sid	varbinary(85)	이 프록시에 대한 Windows 사용자의 Windows 보안 ID입니다.
credential_id	int	이 프록시와 연결된 자격 증명의 식별자입니다.
credential_identity_exists	int	credential_identity 있는지 여부입니다. { 0 = 존재하지 않습니다. 1 = exists }

설명

매개 변수가 제공되지 않으면 sp_help_proxy 인스턴스의 모든 프록시에 대한 정보를 나열합니다.

로그인이 지정된 하위 시스템에 사용할 수 있는 프록시를 확인하려면 이름 및 subsystem_name 지정합니다. 이러한 인수가 제공되면 sp_help_proxy 지정된 로그인이 액세스할 수 있고 지정된 하위 시스템에 사용될 수 있는 프록시를 나열합니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 SQLAgentOperatorRole 고정 데이터베이스 역할을 부여 받아야 합니다.

SQLAgentOperatorRole에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하세요.

참고 항목

credential_identity 및 user_sid 열은 sysadmin 멤버가 이 저장 프로시저를 실행할 때만 결과 집합에 반환됩니다.

예

A. 모든 프록시에 대한 정보 나열

다음 예제에서는 인스턴스의 모든 프록시에 대한 정보를 나열합니다.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_proxy ;  
GO  

B. 특정 프록시에 대한 정보 나열

다음 예제에서는 이름이 지정된 Catalog application proxy프록시에 대한 정보를 나열합니다.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_proxy  
    @proxy_name = N'Catalog application proxy' ;  
GO  

참고 항목

SQL Server 에이전트 저장 프로시저(Transact-SQL)
sp_add_proxy(Transact-SQL)
sp_delete_proxy(Transact-SQL)