Utilidad RS.exe (SSRS)

La utilidad rs.exe procesa el script que proporcione en un archivo de entrada. Use esta utilidad para automatizar las tareas de implementación y administración del servidor de informes.

En este tema:

• Ubicación del archivo

• Argumentos

• Permisos

• Ejemplos

Sintaxis

  
      rs {-?}  
{-i input_file=}  
{-s serverURL}  
{-u username}  
{-p password}  
{-e endpoint}  
{-l time_out}  
{-b batchmode}  
{-v globalvars=}  
{-t trace}  

Ubicación del archivo

RS.exe se encuentra en \Archivos de programa\Microsoft SQL Server\110\Tools\Binn. Puede ejecutar la utilidad desde cualquier carpeta del sistema de archivos.

Argumentos

-?
(Opcional) Muestra la sintaxis de los argumentos de rs .

-iinput_file
(Obligatorio) Especifica el archivo .rss que debe ejecutarse. Este valor puede ser una ruta de acceso relativa o una ruta de acceso completa al archivo .rss.

-sserverURL
(Obligatorio) Especifica el nombre del servidor web y el nombre del directorio virtual del servidor de informes donde debe ejecutarse el archivo. Un ejemplo de una dirección URL de un servidor de informes es http://examplewebserver/reportserver. El prefijo http:// o https:// al principio del nombre del servidor es opcional. Si se omite el prefijo, el host de script del servidor de informes intentará usar primero https y, después, http si https no funciona.

-u [dominio\]nombre de usuario
(Opcional) Especifica una cuenta de usuario que se utiliza para conectarse al servidor de informes. Si se omiten -u y -p, se usa la cuenta de usuario actual de Windows.

-pcontraseña
(Obligatorio si se especifica -u) Especifica la contraseña que debe utilizarse con el argumento -u. Este valor distingue mayúsculas de minúsculas.

-e
(Opcional) Especifica el extremo SOAP en el que debe ejecutarse el script. Los valores válidos son los siguientes:

• Mgmt2010

• Mgmt2006

• Mgmt2005

• Exec2005

Si no se especifica ningún valor, se utilizará el extremo Mgmt2005. Para obtener más información acerca de los extremos SOAP, vea Report Server Web Service Endpoints.

-ltime_out
(Opcional) Especifica el número de segundos que deben transcurrir antes de que se agote el tiempo de espera de la conexión al servidor. El valor predeterminado es 60 segundos. Si no se especifica ningún valor de tiempo de espera, se utiliza el valor predeterminado. El valor 0 indica que nunca se agota el tiempo de espera de la conexión.

-b
(Opcional) Especifica que los comandos del archivo de script se ejecutan en un lote. Si se produce un error en alguno de los comandos, se revierte el lote. Algunos comandos no se pueden ejecutar por lotes y se ejecutan de la manera habitual. Solo si se producen excepciones que no se controlan dentro del script tiene lugar una operación de reversión. Si el script controla una excepción y vuelve con normalidad desde Main, se confirma el lote. Si omite este parámetro, los comandos se ejecutan sin crear un lote. Para obtener más información, consulte Batching Methods.

-vglobalvar
(Opcional) Especifica las variables globales que se usan en el script. Si el script utiliza variables globales, debe especificar este argumento. El valor que especifique debe ser válido para la variable global definida en el archivo .rss. Debe especificar una variable global para cada argumento -v.

El argumento -v se especifica en la línea de comandos y se usa para establecer el valor de una variable global que se define en el script en tiempo de ejecución. Por ejemplo, si el script contiene una variable con nombre parentFolder, puede especificar un nombre para dicha carpeta en la línea de comandos:

rs.exe -i myScriptFile.rss -s http://myServer/reportserver -v parentFolder="Financial Reports"

Se crean variables globales con los nombres indicados y se establecen en los valores proporcionados. Por ejemplo, -v a="1" -v b="2" da como resultado una variable denominada a con un valor de"1" y una variable b con un valor de "2".

Las variables globales están disponibles para todas las funciones del script. Si se especifica una barra diagonal inversa y comillas (\"), se interpreta como comillas dobles. Las comillas solo son necesarias si la cadena contiene un espacio. Los nombres de las variables deben ser válidos para Microsoft Visual Basic; deben comenzar por un carácter alfabético o de subrayado y deben contener caracteres alfabéticos, dígitos o caracteres de subrayado. No se pueden utilizar palabras reservadas como nombres de variables. Para obtener más información sobre las variables globales, consulte Colecciones integradas en expresiones (Generador de informes y SSRS).

-t
(Opcional) Muestra mensajes de error en el registro de seguimiento. Este argumento no toma ningún valor. Para obtener más información, consulte Report Server Service Trace Log.

Permisos

Para ejecutar la herramienta, debe tener permiso para conectarse a la instancia del servidor de informes en la que se está ejecutando el script. Puede ejecutar scripts para realizar cambios en el equipo local o en un equipo remoto. Para realizar cambios en un servidor de informes instalado en un equipo remoto, especifique el equipo remoto en el argumento -s.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el archivo de script que contiene el script de Visual Basic .NET y los métodos del servicio Web que se desea ejecutar.

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

Para obtener un ejemplo detallado, vea Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Para ver otros ejemplos, vea Ejecutar un archivo de script de Reporting Services.

Observaciones

Puede definir scripts para establecer propiedades del sistema, publicar informes, etc. Los scripts que crea pueden incluir cualquier método de la API Reporting Services . Para obtener más información sobre los métodos y las propiedades disponibles, vea Report Server Web Service.

Es necesario escribir el script en código de Visual Basic .NET y guardarlo en un archivo de texto Unicode o UTF-8 con la extensión de nombre de archivo .rss. No se pueden depurar scripts mediante la utilidad rs . Para depurar un script, ejecute el código dentro de Microsoft Visual Studio.

Consulte también

Ejecución de un archivo de script de Reporting Services
Script para tareas administrativas y de implementación
Script con la utilidad rs.exe y el servicio web
Utilidades del símbolo del sistema del servidor de informes (SSRS)