Программа rs
Обрабатывает скрипт, указанный во входном файле. Эта программа служит для автоматизации развертывания сервера отчетов и административных задач.
.gif "Важное примечание") Важно! |
|---|
Выполнение программы 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 без ошибок, то пакет фиксируется. Если этот параметр не указан, то команды выполняются без создания пакета. Дополнительные сведения см. в разделе Методы пакетной работы.-e
(Необязательно) Определяет конечную точку SOAP, относительно которой должен выполняться сценарий. К допустимым значениям относятся Exec2005 или Mgmt2005. Если значение не указано, то используется конечная точка Mgmt2005. Имейте в виду, что поддержка значения Mgmt2000 в этой версии прекращена, и оно больше не является допустимым. Кроме того, программа rs.exe не поддерживает режим интеграции с SharePoint, поэтому список допустимых значений не включает конечную точку ReportService2006. Дополнительные сведения о конечных точках SOAP и устаревших функциях см. в разделах Конечные точки веб-службы сервера отчетов и Устаревшие функции служб SQL Server 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".
Глобальные переменные доступны для любой функции в сценарии. Обратная косая черта и кавычка (\") интерпретируются как двойная кавычка. Кавычки требуются только в том случае, если строка содержит пробелы. Имена переменных должны быть допустимыми для MicrosoftVisual Basic; они должны начинаться с буквы или с символа подчеркивания и содержать буквы, цифры или символы подчеркивания. Зарезервированные слова не могут использоваться в качестве имен переменных. Дополнительные сведения об использовании глобальных переменных см. в разделе Применение встроенных коллекций в выражениях (службы Reporting Services).
-t
(Необязательно) Записывает сообщения об ошибках в журнал трассировки. Этот аргумент не принимает значения. Дополнительные сведения см. в разделе Журнал трассировки службы сервера отчетов.
Разрешения
Для запуска этого средства необходимо иметь разрешение на подключение к экземпляру сервера отчетов, с которым работает выполняемый сценарий. Можно выполнять сценарии для внесения изменений на локальном или удаленном компьютере. Для внесения изменений на сервере отчетов, установленном на удаленном компьютере, укажите удаленный компьютер в аргументе -s.
Примеры
В следующем примере показано, как указать файл сценария, содержащий сценарий на Visual Basic .NET, и методы веб-службы, которые требуется выполнить.
rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
.gif "Примечание") Примечание |
|---|
Службы Reporting Services включают несколько файлов с примерами сценариев, которые можно использовать для изучения того, как включить методы веб-службы сервера отчетов в сценарий Visual Basic .NET. Дополнительные сведения см. в разделе Sample Scripts. |
Местоположение файла
Программа rs.exe расположена в папке \Program Files\Microsoft SQL Server\100\Tools\Binn. Программу можно запустить из любой папки файловой системы.
Замечания
Можно определять сценарии, устанавливать системные свойства, публиковать отчеты и так далее. Создаваемые сценарии могут включать любые методы API-интерфейса служб Reporting Services. Дополнительные сведения о доступных методах и свойствах см. в разделе Веб-служба сервера отчетов.
Сценарий должен быть написан на языке Visual Basic .NET и сохранен в текстовом файле в кодировке Юникод или UTF-8 с расширением RSS. Нельзя проводить отладку сценариев с помощью программы rs. Чтобы провести отладку сценария, выполните код в MicrosoftVisual Studio.