다음을 통해 공유

  • 아티클

rs 유틸리티

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

[!참고]

SQL Server 2008 R2부터는 rs 유틸리티가 SharePoint 통합 모드용으로 구성된 보고서 서버와 기본 모드에서 구성된 서버에 대해 모두 지원됩니다. 이전 버전에서는 기본 모드 구성만 지원되었습니다.

구문

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

인수

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

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

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

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

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

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

    • Mgmt2010

    • Mgmt2006

    • Mgmt2005

    • Exec2005

    값이 지정되지 않은 경우 Mgmt2005가 끝점으로 사용됩니다. 이 릴리스에서는 Mgmt2000 값은 더 이상 사용되지 않으며 유효한 값이 아닙니다. SOAP 끝점과 사용되지 않는 기능에 대한 자세한 내용은 보고서 서버 웹 서비스 끝점 및 SQL Server Reporting Services에서 지원되지 않는 기능을 참조하십시오.

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

  • -b
    스크립트 파일의 명령이 일괄적으로 실행되도록 지정합니다(옵션). 실패하는 명령이 있으면 이 일괄 처리가 롤백됩니다. 일부 명령은 일괄 처리 방식이 아닌 일반적인 방식으로 실행됩니다. 스크립트 내에서 발생되며 처리되지 않는 예외만 롤백됩니다. 스크립트가 예외를 처리하고 Main에서 정상적으로 반환되는 경우 일괄 처리가 커밋됩니다. 이 매개 변수를 생략하면 명령이 일괄 처리를 만들지 않고 실행됩니다. 자세한 내용은 일괄 처리 메서드를 참조하십시오.

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

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

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

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

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

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

사용 권한

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

예

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

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

다른 예제를 보려면 Reporting Services 스크립트 파일 실행을 참조하십시오.

파일 위치

RS.exe는 \Program Files\Microsoft SQL Server\100\Tools\Binn에 있습니다. 파일 시스템의 모든 폴더에서 유틸리티를 실행할 수 있습니다.

주의

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

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