RS.exe 유틸리티(SSRS)RS.exe Utility (SSRS)

RS.exe 유틸리티에서는 입력 파일에 제공된 스크립트를 처리합니다.The rs.exe utility processes script that you provide in an input file. 이 유틸리티를 사용하여 보고서 서버 배포 및 관리 태스크를 자동화할 수 있습니다.Use this utility to automate report server deployment and administration tasks.

참고

SQL Server 2008 R2SQL Server 2008 R2부터는 rs 유틸리티가 SharePoint 통합 모드용으로 구성된 보고서 서버와 기본 모드에서 구성된 서버에 대해 모두 지원됩니다.Beginning with SQL Server 2008 R2SQL Server 2008 R2, the rs utility is supported against report servers that are configured for SharePoint integrated mode as well as servers configured in native mode. 이전 버전에서는 기본 모드 구성만 지원되었습니다.Previous versions only supported native mode configurations.

구문Syntax


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

파일 위치File Location

RS.exe\Program Files\Microsoft SQL Server\110\Tools\Binn에 있습니다.RS.exe is located at \Program Files\Microsoft SQL Server\110\Tools\Binn. 파일 시스템의 모든 폴더에서 유틸리티를 실행할 수 있습니다.You can run the utility from any folder on your file system.

인수Arguments

-?-?
(옵션) rs 인수의 구문을 표시합니다.(Optional) Displays the syntax of rs arguments.

-i input_file-i input_file
실행할 .rss 파일을 지정합니다(필수).(Required) Specifies the .rss file to execute. 이 값은 .rss 파일의 상대 경로 또는 정규화된 경로여야 합니다.This value can be a relative or fully qualified path to the .rss file.

-s serverURL-s serverURL
파일을 실행할 웹 서버 이름 및 보고서 서버 가상 디렉터리를 지정합니다(필수).(Required) Specifies the Web server name and report server virtual directory name to execute the file against. 보고서 서버 URL의 예는 http://examplewebserver/reportserver입니다.An example of a report server URL is http://examplewebserver/reportserver. 서버 이름의 시작 부분에 붙는 접두사 http:// 또는 https://는 옵션입니다.The prefix http:// or https:// at the beginning of the server name is optional. 이를 생략하면 보고서 서버 스크립트 호스트에서 https를 먼저 사용해 본 다음 작동하지 않는 경우 http를 사용합니다.If you omit the prefix, the report server script host tries to use https first, and then uses http if https does not work.

-u [domain\]username-u [domain\]username
보고서 서버에 연결하는 데 사용되는 사용자 계정을 지정합니다(옵션).(Optional) Specifies a user account used to connect to the report server. -u-p 를 생략하면 현재 Windows 사용자 계정이 사용됩니다.If -u and -p are omitted, the current Windows user account is used.

-p password-p password
-u 인수에 사용할 암호를 지정합니다( -u 를 지정한 경우 필수).(Required if -u is specified) Specifies the password to use with the -u argument. 이 값은 대/소문자를 구분합니다.This value is case-sensitive.

-e-e
스크립트가 실행되어야 하는 대상 SOAP 끝점을 지정합니다(옵션).(Optional) Specifies the SOAP endpoint against which the script should run. 유효한 값은 다음과 같습니다.Valid values are the following:

  • Mgmt2010Mgmt2010

  • Mgmt2006Mgmt2006

  • Mgmt2005Mgmt2005

  • Exec2005Exec2005

    값이 지정되지 않은 경우 Mgmt2005가 끝점으로 사용됩니다.If a value is not specified, the Mgmt2005 endpoint is used. SOAP 끝점에 대한 자세한 내용은 Report Server Web Service Endpoints을 참조하세요.For more information about the SOAP endpoints, see Report Server Web Service Endpoints.

    -l time_out-l time_out
    서버에 대한 연결 제한 시간이 초과하기 전까지의 시간(초)을 지정합니다(옵션). 기본값은 60초입니다.(Optional) Specifies the number of seconds that elapse before the connection to the server times out. The default is 60 seconds. 시간 제한 값을 지정하지 않으면 이 기본값이 사용됩니다.If you do not specify a time-out value, the default is used. 값을 0 으로 지정하면 연결 시간 제한이 없습니다.A value of 0 specifies that the connection never times out.

    -b-b
    스크립트 파일의 명령이 일괄적으로 실행되도록 지정합니다(옵션).(Optional) Specifies that the commands in the script file run in a batch. 실패하는 명령이 있으면 이 일괄 처리가 롤백됩니다.If any commands fail, the batch is rolled back. 일부 명령은 일괄 처리 방식이 아닌 일반적인 방식으로 실행됩니다.Some commands cannot be batched, and those run as usual. 스크립트 내에서 발생되며 처리되지 않는 예외만 롤백됩니다.Only exceptions that are thrown and are not handled within the script result in a rollback. 스크립트가 예외를 처리하고 Main에서 정상적으로 반환되는 경우 일괄 처리가 커밋됩니다.If the script handles an exception and returns normally from Main, the batch is committed. 이 매개 변수를 생략하면 명령이 일괄 처리를 만들지 않고 실행됩니다.If you omit this parameter, the commands run without creating a batch. 자세한 내용은 Batching Methods을 참조하세요.For more information, see Batching Methods.

    -v globalvar-v globalvar
    스크립트에서 사용되는 전역 변수를 지정합니다(옵션).(Optional) Specifies global variables that are used in the script. 스크립트에서 전역 변수가 사용되는 경우에는 이 인수를 지정해야 합니다.If the script uses global variables, you must specify this argument. 지정하는 값은 .rss 파일에 정의되는 전역 변수에 대해 유효해야 합니다.The value that you specify must be valid for global variable defined in the .rss file. –v 인수에 대해 하나의 전역 변수를 지정해야 합니다.You must specify one global variable for each –v argument.

    -v 인수는 명령줄에서 지정되며 런타임에 스크립트에 정의된 전역 변수의 값을 설정하는 데 사용됩니다.The -v argument is specified on the command line and is used to set the value for a global variable that is defined in your script at run time. 예를 들어 스크립트에 parentFolder라는 변수가 포함되어 있다면 다음과 같이 명령줄에서 해당 폴더에 대한 이름을 지정할 수 있습니다.For example, if your script contains a variable named parentFolder, you can specify a name for that folder on the command line:

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

    전역 변수가 지정한 이름으로 생성된 다음 제공된 값으로 설정됩니다.Global variables are created with the names given and set to the values supplied. 예를 들어 -v a="1" -v b="2"를 지정하면 a 수에는 "1" 값이 지정되고 b 변수에는 "2" 값이 지정됩니다.For example, -v a="1" -v b="2" results in a variable named a with a value of"1" and a variable b with a value of "2".

    전역 변수는 스크립트의 모든 함수에서 사용할 수 있습니다.Global variables are available to any function in the script. 백슬래시와 인용 부호(\")는 큰따옴표로 해석됩니다.A backslash and quotation mark (\") is interpreted as a double quotation mark. 인용 부호는 문자열에 공백이 포함되어 있는 경우에만 필요합니다.The quotation marks are required only if the string contains a space. 변수 이름은 MicrosoftMicrosoft Visual BasicVisual Basic에 유효해야 하며 알파벳 문자 또는 밑줄로 시작하고 알파벳 문자, 숫자 또는 밑줄이 포함되어야 합니다.Variable names must be valid for MicrosoftMicrosoft Visual BasicVisual Basic; they must start with alphabetical character or underscore and contain alphabetical characters, digits, or underscores. 예약어는 변수 이름으로 사용할 수 없습니다.Reserved words cannot be used as variable names. 전역 변수 사용에 대한 자세한 내용은 식의 기본 제공 컬렉션(보고서 작성기 및 SSRS)을 참조하세요.For more information about using global variables, see Built-in Collections in Expressions (Report Builder and SSRS).

    -t-t
    추적 로그에 오류 메시지를 출력합니다(옵션).(Optional) Outputs error messages to the trace log. 이 인수는 값을 가지지 않습니다.This argument does not take a value. 자세한 내용은 Report Server Service Trace Log을 참조하세요.For more information, see Report Server Service Trace Log.

PermissionsPermissions

이 도구를 사용하려면 스크립트를 실행하는 보고서 서버 인스턴스에 연결할 수 있는 사용 권한이 필요합니다.To run the tool, you must have permission to connect to the report server instance you are running the script against. 스크립트를 실행하여 로컬 컴퓨터나 원격 컴퓨터를 변경할 수 있습니다.You can run scripts to make changes to the local computer or a remote computer. 원격 컴퓨터에 설치된 보고서 서버를 변경하려면 -s 인수에 원격 컴퓨터를 지정합니다.To make changes to a report server installed on a remote computer, specify the remote computer in the -s argument.

Examples

다음 예에서는 실행할 Visual BasicVisual Basic .NET 스크립트 및 웹 서비스 메서드가 포함된 스크립트 파일을 지정하는 방법을 보여 줍니다.The following example illustrates how to specify the script file that contains Visual BasicVisual Basic .NET script and Web service methods that you want to execute.

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

자세한 예제는 보고서 서버 간 콘텐츠 복사를 위한 예제 Reporting Services rs.exe 스크립트를 참조하세요.For a detailed example, see Sample Reporting Services rs.exe Script to Copy Content between Report Servers.

추가 예제는 Reporting Services 스크립트 파일 실행을 참조하세요.For additional examples, see Run a Reporting Services Script File

주의Remarks

시스템 속성을 설정하고 보고서를 게시하는 등의 스크립트를 정의할 수 있습니다.You can define scripts to set system properties, publish reports, and so forth. 생성된 스크립트에는 Reporting ServicesReporting Services API의 모든 메서드가 포함될 수 있습니다.The scripts that you create can include any methods of the Reporting ServicesReporting Services API. 사용할 수 있는 메서드 및 속성에 대한 자세한 내용은 Report Server Web Service를 참조하세요.For more information about the methods and properties available to you, see Report Server Web Service.

이 스크립트는 Visual BasicVisual Basic .NET 코드로 작성하여 파일 이름 확장명이 .rss인 유니코드 또는 UTF-8 텍스트 파일로 저장해야 합니다.The script must be written in Visual BasicVisual Basic .NET code, and stored in a Unicode or UTF-8 text file with an .rss file name extension. rs 유틸리티를 사용하여 스크립트를 디버깅할 수 없습니다.You cannot debug scripts with the rs utility. 스크립트를 디버깅하려면 MicrosoftMicrosoft Visual StudioVisual Studio에서 코드를 실행하세요.To debug a script, run the code within MicrosoftMicrosoft Visual StudioVisual Studio.

관련 항목:See Also