Utilidad RS.exe (SSRS)

  • Artículo

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.

Nota:

A partir de SQL Server 2008 R2 (10.50.x), la utilidad rs se admite con los servidores de informes configurados para el modo integrado de SharePoint, así como para los servidores configurados en modo nativo. Las versiones anteriores solo eran compatibles con las configuraciones del modo nativo.

Sintaxis

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

Ubicación de los archivos

El archivo RS.exe se encuentra en las siguientes carpetas, según la versión del servidor de informes. Puede ejecutar la utilidad desde cualquier carpeta del sistema de archivos.

Se aplica a: SQL Server Reporting Services (2016)

C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn

Se aplica a: SQL Server Reporting Services (2017 y versiones posteriores)

C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools

Se aplica a: Power BI Report Server

C:\Program Files\Microsoft Power BI Report Server\Shared Tools

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.

-sURL_Del_Servidor
(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 https://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\]nombreDeUsuario
(Opcional) Especifica una cuenta de usuario que se utiliza para conectarse al servidor de informes. Si se omiten -u y -p , se usará la cuenta de usuario de Windows actual.

-pcontraseña
(Obligatorio si se especifica -u ) Especifica la contraseña que se usará 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:

  • 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, consulta 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, consulta Batching Methods.

-vvariables_globales
(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 https://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 llamada 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 variable 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, consulta 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 Registro de seguimiento del servicio del servidor de informes.

Permisos

Para ejecutar la herramienta, debes 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 ver un ejemplo detallado, consulta Script rs.exe de ejemplo de Reporting Services para copiar contenido entre servidores de informes.

Para ver más ejemplos, consulta Ejecutar un archivo de script de Reporting Services.

Comentarios

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, consulta 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.

Sugerencia

Para ver un ejemplo detallado, consulta Script rs.exe de ejemplo de Reporting Services para copiar contenido entre servidores de informes.

Contenido relacionado