rs, программа (rs.exe) (SSRS)
Служебная программа rs.exe обрабатывает скрипт, предоставленный во входном файле. Используйте эту программу для автоматизации развертывания сервера отчетов и административных задач.
.gif "Примечание") Примечание |
|---|
Начиная с 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.exe находится в папке \Program Files\Microsoft SQL Server\110\Tools\Binn. Программу можно запустить из любой папки файловой системы.
Аргументы
-?
(Необязательно) Показывает синтаксис аргументов 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 в SQL Server 2012
-l time_out
(Необязательный) Определяет количество секунд, которые должны пройти до истечения времени ожидания соединения с сервером. Значение по умолчанию составляет 60 секунд. Если значение времени ожидания не определено, то используется значение по умолчанию. Значение 0 определяет бесконечное время ожидания соединения.-b
(Необязательный) Задает пакетное выполнение команд файла скрипта. В случае ошибки любой из команд происходит откат всего пакета к прежнему состоянию. Некоторые команды не могут быть помещены в пакет и будут выполняться обычным способом. Откат вызывается только исключениями, которые возникли, но не обрабатываются скриптом. Если скрипт обрабатывает исключение и возвращается из функции Main без ошибок, пакет фиксируется. Если этот параметр не указан, то команды выполняются без создания пакета. Дополнительные сведения см. в разделе Методы пакетной работы.-v globalvar
(Необязательный) Определяет глобальные переменные, которые используются в скрипте. Если скрипт использует глобальные переменные, то необходимо задать этот аргумент. Задаваемое значение должно быть допустимым для глобальной переменной, определенной в файле 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; они должны начинаться с буквы или с символа подчеркивания и содержать буквы, цифры или символы подчеркивания. Зарезервированные слова не могут использоваться в качестве имен переменных. Дополнительные сведения об использовании глобальных переменных см. в разделе Встроенные коллекции в выражениях (построитель отчетов и службы SSRS).
-t
(Необязательный) Записывает сообщения об ошибках в журнал трассировки. Этот аргумент не принимает значения. Дополнительные сведения см. в разделе Журнал трассировки службы сервера отчетов.
Разрешения
Для запуска этого средства необходимо иметь разрешение на подключение к экземпляру сервера отчетов, с которым работает выполняемый скрипт. Можно выполнять скрипты для внесения изменений на локальном или удаленном компьютере. Для внесения изменений на сервере отчетов, установленном на удаленном компьютере, укажите удаленный компьютер в аргументе -s.
Примеры
В следующем примере показано, как задать файл скрипта, содержащего скрипт Visual Basic .NET, и методы веб-службы, которые требуется выполнить.
rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
Подробный пример см. в разделе Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.
Дополнительные примеры см. в разделе Запустить файл скрипта служб Reporting Services.
Замечания
Можно определять скрипты, устанавливать системные свойства, публиковать отчеты и так далее. Создаваемые скрипты могут включать любые методы API-интерфейса служб Службы Reporting Services. Дополнительные сведения о доступных методах и свойствах см. в разделе Веб-служба сервера отчетов.
Скрипт должен быть написан на языке Visual Basic .NET и храниться в текстовом файле в кодировке Юникод или UTF-8 с расширением RSS. Отладить скрипт с помощью программы rs невозможно. Для отладки скрипта выполните код в Microsoft Visual Studio.
См. также
Основные понятия
Запустить файл скрипта служб Reporting Services
Написание сценариев для задач развертывания и администрирования
Программы командной строки сервера отчетов (SSRS)