rs (utilidad)

  • Artículo

Procesa las secuencias de comandos que se proporcionan en un archivo de entrada. Use esta utilidad para automatizar las tareas de implementación y administración del servidor de informes.

ms162839.note(es-es,SQL.90).gifImportante:
La utilidad rs no se admite en los servidores de informes configurados para el modo integrado de SharePoint.

Sintaxis


rs {-?}
[-iinput_file=]
[-sserverURL]
{-uusername}
{-ppassword}
{-ltime_out}
{-bbatchmode}
{-vglobalvars=}
{-eendpoint}
{-ttrace}

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 secuencias de comandos del servidor de informes intentará usar primero https y, después, http si https no funciona.
  • -u [domain\]nombreDeUsuario
    (Opcional) Especifica una cuenta de usuario que se utiliza para conectarse al servidor de informes. Si se omiten -u y -p, se utiliza la cuenta de usuario actual de Windows.
  • -ppassword
    (Obigatorio si se especifica -u) Especifica la contraseña que debe utilizarse con el argumento -u. Este valor distingue mayúsculas de minúsculas.
  • -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 secuencias de comandos 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. Sólo si se producen excepciones que no se controlan dentro de la secuencia de comandos tiene lugar una operación de reversión. Si la secuencia de comandos 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 Batching Methods.

  • -vglobalvar
    (Opcional) Especifica las variables globales que se utilizan en la secuencia de comandos. Si la secuencia de comandos utiliza variables globales, debe especificar este argumento. El valor que especifique deberá 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 utiliza para establecer el valor de una variable global que se define en su secuencia de comandos en tiempo de ejecución. Por ejemplo, si su secuencia de comandos contiene una variable denominada parentFolder, puede especificar un nombre para esa 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 "1" y una variable b con un valor "2".

    Las variables globales están disponibles para todas las funciones de la secuencia de comandos. Si se especifica una barra diagonal inversa y comillas (\"), se interpreta como comillas dobles. Las comillas sólo 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 Usar colecciones globales en expresiones (Reporting Services).

Permisos

Para ejecutar la herramienta, debe tener permiso para conectarse a la instancia del servidor de informes en la que se está ejecutando la secuencia de comandos. Puede ejecutar secuencias de comandos 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 siguiente ejemplo se muestra la forma de especificar el archivo de secuencias de comandos que contiene las secuencias de comandos 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

[!NOTA] Reporting Services incluye una serie de archivos de secuencias de comandos de ejemplo que puede utilizar para aprender a incorporar métodos del servicio Web del servidor de informes en secuencias de comandos de Visual Basic .NET. Para obtener más información, vea Ejemplos de secuencias de comandos (Reporting Services).

Ubicación del archivo

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

Notas

Puede definir secuencias de comandos para establecer propiedades del sistema, publicar informes, etc. Estas secuencias de comandos pueden incluir cualquiera de los métodos de la interfaz de programación de la aplicación Reporting Services. Para obtener más información sobre los métodos y las propiedades disponibles, vea Report Server Web Service.

La secuencia de comandos debe escribirse en código de Visual Basic .NET y debe almacenarse en un archivo de texto Unicode o UTF-8 con extensión .rss. No puede depurar secuencias de comandos mediante la utilidad rs. Para depurarlas, ejecute el código desde Microsoft Visual Studio.

Vea también

Otros recursos

Running a Reporting Services Script File
Secuencias de comandos para tareas administrativas y de implementación
Scripting with the rs Utility and the Web Service
Utilidades de símbolo del sistema del servidor de informes

Ayuda e información

Obtener ayuda sobre SQL Server 2005