Utilidad rs (rs.exe) (SSRS)
La utilidad rs.exe procesa el script que proporcione como 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, 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 admitían 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 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.-i input_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.-s serverURL
(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 [domain\]username
(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.-p password
(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. Observe que el valor Mgmt2000 es discontinuo en esta versión y ya no es un valor válido. Para obtener más información acerca de los extremos SOAP y las características desusadas, vea Extremos de servicios web del servidor de informes y Características desusadas de SQL Server Reporting Services en SQL Server 2012
-l time_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, vea Métodos de procesamiento por lotes.-v globalvar
(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 el valor "1" y una variable b con el valor "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 el uso de las variables globales, vea 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, vea Registro de seguimiento del servicio del servidor de informes.
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 obtener otros ejemplos, vea 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, vea Servicio web del servidor de informes.
El script debe escribirse en código de Visual Basic .NET y debe almacenarse 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.
Vea también
Conceptos
Ejecutar un archivo de script de Reporting Services
Scripting para tareas administrativas y de implementación
Utilidades del símbolo del sistema del servidor de informes (SSRS)