Программа rs
Обрабатывает скрипт, указанный во входном файле. Используйте эту программу для автоматизации развертывания сервера отчетов и административных задач.
.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.-i входной_файл
(обязательный) Определяет файл rss, подлежащий выполнению. Это значение может быть как относительным, так и полным путем к файлу rss.-s serverURL
(обязательный) Определяет имя веб-сервера и имя виртуального каталога сервера отчетов, к которым будет применен выполняемый файл. Пример URL-адреса сервера отчетов: http://examplewebserver/reportserver. Префикс http:// или https: // в начале имени сервера необязателен. Если префикс не указан, то сервер, на котором находится скрипт сервера отчетов, сначала пытается использовать протокол HTTPS, а в случае неудачи — протокол HTTP.-u [домен\]имя_пользователя
(Необязательный) Определяет учетную запись пользователя, используемую для подключения к серверу отчетов. В случае отсутствия -u и -p используется текущая учетная запись пользователя Windows.-p пароль
(обязательный, если задан -u) Определяет пароль для использования с аргументом -u. Это значение учитывает регистр.-e
(Необязательный) Определяет конечную точку SOAP, с которой должен выполняться скрипт. Допустимы следующие значения.Mgmt2010
Mgmt2006
Mgmt2005
Exec2005
Если значение не указано, то используется конечная точка Mgmt2005. Имейте в виду, что поддержка значения Mgmt2000 в этом выпуске прекращена, и оно больше не является допустимым. Дополнительные сведения о конечных точках SOAP и устаревших функциях см. в разделах Конечные точки веб-службы сервера отчетов и Устаревшие функции служб SQL Server Reporting Services
-l время_ожидания
(Необязательный) Определяет количество секунд, которые должны пройти до истечения времени ожидания соединения с сервером. Значение по умолчанию — 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. Программу можно запустить из любой папки файловой системы.
Замечания
Можно определять скрипты, устанавливать системные свойства, публиковать отчеты и так далее. Создаваемые скрипты могут включать любые методы API-интерфейса служб Службы Reporting Services. Дополнительные сведения о доступных методах и свойствах см. в разделе Веб-служба сервера отчетов.
Скрипт должен быть написан на языке Visual Basic .NET и сохранен в текстовом файле в кодировке Юникод или UTF-8 с расширением RSS. Нельзя проводить отладку скриптов с помощью программы rs. Для отладки скрипта выполните код в Microsoft Visual Studio.