служебная программа RS.exe (SSRS)

  • Статья

Скрипт, предоставленный во входном файле, обрабатывается служебной программой rs.exe. Используйте эту программу для автоматизации развертывания сервера отчетов и административных задач.

Примечание.

Начиная с SQL Server 2008 R2 (10.50.x), программа rs поддерживается для серверов отчетов, настроенных для интегрированного режима SharePoint, а также серверов, настроенных в собственном режиме. В предыдущих версиях поддерживалась только работа в собственном режиме.

Синтаксис

  
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.

-sURL-адрес_сервера
(обязательный) Определяет имя веб-сервера и имя виртуального каталога сервера отчетов, к которым будет применен выполняемый файл. Пример URL-адреса сервера отчетов: https://examplewebserver/reportserver. Префикс http:// или https: // в начале имени сервера необязателен. Если префикс опущен, узел скрипта сервера отчетов сначала пытается использовать https, а затем использует http, если https не работает.

-u[домен\]имя_пользователя
(Необязательный) Определяет учетную запись пользователя, используемую для подключения к серверу отчетов. В случае отсутствия -u и -p используется текущая учетная запись пользователя Windows.

-p<пароль>
(Обязательный, если задан -u .) Определяет пароль для использования с аргументом -u . Это значение учитывает регистр.

-e
(Необязательный) Определяет конечную точку SOAP, с которой должен выполняться скрипт. Допустимые значения:

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Если значение не указано, используется конечная точка Mgmt2005. Дополнительные сведения о конечных точках SOAP см. в статье "Конечные точки веб-службы сервера отчетов".

-lвремя_ожидания
(Необязательно) Указывает количество секунд, истекающих до истечения времени ожидания подключения к серверу. Значение по умолчанию — 60 секунд. Если значение времени ожидания не указано, используется значение по умолчанию. Значение 0 определяет бесконечное время ожидания соединения.

-b
(Необязательный) Задает пакетное выполнение команд файла скрипта. В случае ошибки любой из команд происходит откат всего пакета к прежнему состоянию. Некоторые команды не могут быть пакетированы, и эти команды выполняются как обычно. Только исключения, которые создаются и не обрабатываются в скрипте, приводят к откату. Если скрипт обрабатывает исключение и возвращается из функции Mainбез ошибок, пакет фиксируется. Если этот параметр не указан, то команды выполняются без создания пакета. Дополнительные сведения см. в разделе "Методы пакетной обработки".

-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"

Замечания

Можно определять скрипты, устанавливать системные свойства, публиковать отчеты и так далее. Создаваемые скрипты могут включать любые методы API служб Reporting Services. Дополнительные сведения о методах и свойствах, доступных для вас, см . в веб-службе сервера отчетов.

Скрипт должен быть написан в коде .NET Visual Basic и храниться в текстовом файле Юникода или UTF-8 с расширением имени файла .rss. Вы не можете отлаживать скрипты с помощью программы rs . Чтобы выполнить отладку скрипта, запустите код в Microsoft Visual Studio.

Совет

Подробный пример см . в примере скрипта служб Reporting Services rs.exe для копирования содержимого между серверами отчетов.

Связанный контент