SSRS(RS.exe 유틸리티)

RS.exe 유틸리티에서는 입력 파일에 제공된 스크립트를 처리합니다. 이 유틸리티를 사용하여 보고서 서버 배포 및 관리 태스크를 자동화할 수 있습니다.

구문

  
rs {-?}  
{-i input_file}  
{-s serverURL}  
{-u username}  
{-p password}  
{-e endpoint}  
{-l time_out}  
{-b batchmode}  
{-v globalvars=}  
{-t trace}  

파일 위치

RS.exe 보고서 서버 버전에 따라 다음 폴더에 있습니다. 파일 시스템의 모든 폴더에서 유틸리티를 실행할 수 있습니다.

적용 대상: SQL Server Reporting Services(2016)

C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn  

적용 대상: SQL Server Reporting Services(2017 이상)

C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools

적용 대상: Power BI 보고서 서버

C:\Program Files\Microsoft Power BI Report Server\Shared Tools

인수

-?
(옵션) rs 인수의 구문을 표시합니다.

-iinput_file
실행할 .rss 파일을 지정합니다(필수). 이 값은 .rss 파일의 상대 경로 또는 정규화된 경로여야 합니다.

-sserverURL
파일을 실행할 웹 서버 이름 및 보고서 서버 가상 디렉터리를 지정합니다(필수). 보고서 서버 URL의 예는 https://examplewebserver/reportserver입니다. 서버 이름의 시작 부분에 붙는 접두사 http:// 또는 https://는 옵션입니다. 접두사를 생략하면 보고서 서버 스크립트 호스트가 먼저 https를 사용하려고 한 다음 https가 작동하지 않는 경우 http를 사용합니다.

-u [domain\]username
보고서 서버에 연결하는 데 사용되는 사용자 계정을 지정합니다(옵션). -u 와 -p 를 생략하면 현재 Windows 사용자 계정이 사용됩니다.

-ppassword
-u 인수에 사용할 암호를 지정합니다( -u 를 지정한 경우 필수). 이 값은 대/소문자를 구분합니다.

-e
스크립트가 실행되어야 하는 대상 SOAP 엔드포인트를 지정합니다(옵션). 유효한 값은 다음과 같습니다.

• Mgmt2010

• Mgmt2006

• Mgmt2005

• Exec2005

값을 지정하지 않으면 Mgmt2005 엔드포인트가 사용됩니다. SOAP 엔드포인트에 대한 자세한 내용은 보고서 서버 웹 서비스 엔드포인트를 참조 하세요.

-ltime_out
서버에 대한 연결 제한 시간이 초과하기 전까지의 시간(초)을 지정합니다(옵션). 기본값은 60초입니다. 제한 시간 값을 지정하지 않으면 기본값이 사용됩니다. 값을 0 으로 지정하면 연결 시간 제한이 없습니다.

-b
스크립트 파일의 명령이 일괄적으로 실행되도록 지정합니다(옵션). 실패하는 명령이 있으면 이 일괄 처리가 롤백됩니다. 일부 명령은 일괄 처리할 수 없으며 해당 명령은 평소와 같이 실행됩니다. 스크립트 내에서 throw되고 처리되지 않는 예외만 롤백됩니다. 스크립트가 예외를 처리하고 Main에서 정상적으로 반환되는 경우 일괄 처리가 커밋됩니다. 이 매개 변수를 생략하면 명령이 일괄 처리를 만들지 않고 실행됩니다. 자세한 내용은 Batching 메서드를 참조 하세요.

-vglobalvar
스크립트에서 사용되는 전역 변수를 지정합니다(옵션). 스크립트에서 전역 변수가 사용되는 경우에는 이 인수를 지정해야 합니다. 지정하는 값은 .rss 파일에 정의되는 전역 변수에 대해 유효해야 합니다. 각 –v 인수에 대해 하나의 글로벌 변수를 지정해야 합니다.

-v 인수는 명령줄에서 지정되며 런타임에 스크립트에 정의된 전역 변수의 값을 설정하는 데 사용됩니다. 예를 들어 스크립트에 parentFolder라는 변수가 포함되어 있다면 다음과 같이 명령줄에서 해당 폴더에 대한 이름을 지정할 수 있습니다.

rs.exe -i myScriptFile.rss -s https://myServer/reportserver -v parentFolder="Financial Reports"

전역 변수가 지정한 이름으로 생성된 다음 제공된 값으로 설정됩니다. 예를 들어 -v a="1" -v b="2"를 지정하면 a 수에는 "1" 값이 지정되고 b 변수에는 "2" 값이 지정됩니다.

전역 변수는 스크립트의 모든 함수에서 사용할 수 있습니다. 백슬래시와 인용 부호(\")는 큰따옴표로 해석됩니다. 인용 부호는 문자열에 공백이 포함되어 있는 경우에만 필요합니다. 변수 이름은 Microsoft Visual Basic에 유효해야 합니다. 사전순 문자 또는 밑줄로 시작하고 사전순 문자, 숫자 또는 밑줄을 포함해야 합니다. 예약된 단어는 변수 이름으로 사용할 수 없습니다. 전역 변수를 사용하는 방법에 대한 자세한 내용은 식의 기본 제공 컬렉션(보고서 작성기 및 SSRS)을 참조하세요.

-t
추적 로그에 오류 메시지를 출력합니다(옵션). 이 인수는 값을 받지 않습니다. 자세한 내용은 보고서 서버 서비스 추적 로그를 참조 하세요.

사용 권한

도구를 실행하려면 스크립트를 실행 중인 보고서 서버 인스턴스에 연결할 수 있는 권한이 있어야 합니다. 스크립트를 실행하여 로컬 컴퓨터나 원격 컴퓨터를 변경할 수 있습니다. 원격 컴퓨터에 설치된 보고서 서버를 변경하려면 -s 인수에 원격 컴퓨터를 지정합니다.

예

다음 예에서는 실행할 Visual Basic .NET 스크립트 및 웹 서비스 메서드가 포함된 스크립트 파일을 지정하는 방법을 보여 줍니다.

rs -i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver  

자세한 예제는 보고서 서버 간에 콘텐츠를 복사하는 샘플 Reporting Services rs.exe 스크립트를 참조 하세요.

자세한 예제는 Reporting Services 스크립트 파일 실행을 참조 하세요.

설명

시스템 속성을 설정하고 보고서를 게시하는 등의 스크립트를 정의할 수 있습니다. 생성된 스크립트에는 Reporting Services API의 모든 메서드가 포함될 수 있습니다. 사용 가능한 메서드 및 속성에 대한 자세한 내용은 보고서 서버 웹 서비스를 참조하세요.

이 스크립트는 Visual Basic .NET 코드로 작성하여 파일 이름 확장명이 .rss인 유니코드 또는 UTF-8 텍스트 파일로 저장해야 합니다. rs 유틸리티를 사용하여 스크립트를 디버그할 수 없습니다. 스크립트를 디버그하려면 Microsoft Visual Studio에서 코드를 실행하세요.

관련 콘텐츠

• Reporting Services 스크립트 파일 실행
• 배포 및 관리 작업 스크립트
• rs.exe 유틸리티 및 웹 서비스를 사용하여 스크립트
• 보고서 서버 명령 프롬프트 유틸리티(SSRS)