Программа rs

Статья
12/15/2008

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

Важно!
Использование программы rs c серверами отчетов, настроенными для работы в режиме интеграции с SharePoint, не поддерживается.

Синтаксис


rs {-?}
[-iinput_file=]
[-sserverURL]
{-uusername}
{-ppassword}
{-ltime_out}
{-bbatchmode}
{-vglobalvars=}
{-eendpoint}
{-ttrace}

Аргументы

-?
(Необязательно) Отображает синтаксис аргументов rs.

-iвходной_файл
(обязательный) Определяет файл rss, подлежащий выполнению. Это значение может быть как относительным, так и полным путем к файлу rss.

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

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

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

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

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

-e
(Необязательно) Определяет конечную точку SOAP, относительно которой должен выполняться сценарий. Допустимые значения: Exec2005, Mgmt2005 и Mgmt2000. Если значение не указано, то используется конечная точка Mgmt2005. Заметьте, что в этом выпуске значение Mgmt2000 является устаревшим. Дополнительные сведения о конечных точках SOAP и устаревших функциях см. в разделах Report Server Web Service Endpoints и Устаревшие возможности служб SQL Server 2005 Reporting Services.

-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. Они должны начинаться с буквенного символа или знака подчеркивания и содержать буквенные символы, цифры или знаки подчеркивания. Зарезервированные слова не могут использоваться в качестве имен переменных. Дополнительные сведения об использовании глобальных переменных см. в разделе Применение глобальных коллекций в выражениях (службы Reporting Services).

-t
(Необязательно) Записывает сообщения об ошибках в журнал трассировки. Этот аргумент не принимает значения. Дополнительные сведения см. в разделе Журналы трассировки служб Reporting Services.

Разрешения

Для запуска этого средства необходимо иметь разрешение на подключение к экземпляру сервера отчетов, с которым работает выполняемый сценарий. Можно выполнять сценарии для внесения изменений на локальном или удаленном компьютере. Для внесения изменений на сервере отчетов, установленном на удаленном компьютере, укажите удаленный компьютер в аргументе -s.

Примеры

Следующий пример показывает, как указать файл сценария, содержащий сценарий на Visual Basic .NET, и методы веб-службы, которые требуется выполнить.

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

Примечание.
Службы Reporting Services содержат несколько образцов файлов сценария, которые можно использовать для изучения способов включения методов веб-службы сервера отчетов в сценарий Visual Basic .NET. Дополнительные сведения см. в разделе Образцы сценариев (службы Reporting Services).

Службы Reporting Services содержат несколько образцов файлов сценария, которые можно использовать для изучения способов включения методов веб-службы сервера отчетов в сценарий Visual Basic .NET. Дополнительные сведения см. в разделе Образцы сценариев (службы Reporting Services).

Местоположение файла

Файл Rs.exe расположен в папке \Program Files\Microsoft SQL Server\90\Tools\Binn. Программу можно запустить из любой папки файловой системы.

Замечания

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

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

См. также

Другие ресурсы

Running a Reporting Services Script File
Написание сценариев для задач развертывания и администрирования
Scripting with the rs Utility and the Web Service
Программы командной строки сервера отчетов

Справка и поддержка

Получение помощи по SQL Server 2005

Share via