Поделиться через


Программа rs

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

ПримечаниеПримечание

В 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.