Compartir a través de

  • Artículo

rs (utilidad)

Procesa el script que se proporciona en un archivo de entrada. Emplee esta utilidad para automatizar las tareas de administración e implementación del servidor de informes.

Nota importanteImportante

La utilidad rs no se admite en los servidores de informes configurados para el modo integrado con 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 scripts 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
    (Obligatorio 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 scripts 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 por lotes.

  • -e
    (Opcional) Especifica el extremo SOAP en el que debe ejecutarse el script. Los valores válidos son Exec2005 o Mgmt2005. 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. Además, debido a que rs.exe no admite el modo integrado con SharePoint, la lista de valores válidos no incluye el extremo de ReportService2006. Para obtener más información acerca de los extremos SOAP y las características obsoletas, vea Extremos de servicio web del servidor de informes y Características obsoletas de SQL Server Reporting Services.

  • -vglobalvar
    (Opcional) Especifica las variables globales que se utilizan en el script. Si el script 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 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 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 MicrosoftVisual 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 las colecciones integradas en expresiones (Reporting Services).

  • -t
    (Opcional) Muestra mensajes de error en el registro de traza. 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 siguiente ejemplo se muestra la forma de especificar el archivo de scripts que contiene los scripts 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 scripts de ejemplo que puede usar para aprender a incorporar métodos del servicio web del servidor de informes en scripts de Visual Basic .NET. Para obtener más información, vea Sample Scripts.

Ubicación del archivo

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

Notas

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 extensión de nombre de archivo .rss. No puede depurar scripts mediante la utilidad rs. Para depurar un script, ejecute el código dentro de MicrosoftVisual Studio.