rs 实用工具 (rs.exe) (SSRS)SQL server report service

http://msdn.microsoft.com/zh-cn/library/ms162839.aspx

rs 实用工具 (rs.exe) (SSRS)

其他版本

• SQL Server 2008 R2
• SQL Server 2008
• SQL Server 2005

此主题尚未评级- 评价此主题

处理输入文件中提供的脚本。 使用此实用工具，可以实现报表服务器部署与管理任务的自动化。

注意
从 SQL Server 2008 R2 开始，配置为 SharePoint 集成模式的报表服务器以及配置为本机模式的服务器均支持rs 实用工具。 以前的版本仅支持本机模式配置。

语法

复制

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

文件位置

RS.exe 位于 \Program Files\Microsoft SQL Server\110\Tools\Binn。 可以在文件系统的任何文件夹中运行此实用工具。

参数

-?

（可选）显示 rs 参数的语法。

-i   input_file

（必需）指定要执行的 .rss 文件。 此值可以是指向 .rss 文件的相对路径或完全限定路径。

-s   serverURL

（必需）指定执行文件的 Web 服务器的名称和报表服务器的虚拟目录名。 以下是报表服务器 URL 的一个示例：http://examplewebserver/reportserver。服务器名称开头处的前缀 http:// 或 https:// 是可选的。 如果省略前缀，报表服务器脚本主机将先尝试使用 https，并在 https 无效时使用 http。

-u  [ domain\] username

（可选）指定用于连接到报表服务器的用户帐户。 如果省略 -u 和 -p，则使用当前的 Windows 用户帐户。

-p   password

（指定了 -u 时为必需）指定与-u 参数一起使用的密码。 此值区分大小写。

-e

（可选）指定应对其运行脚本的 SOAP 端点。 有效值如下：

• Mgmt2010

• Mgmt2006

• Mgmt2005

• Exec2005

如果未指定值，则使用 Mgmt2005 端点。 请注意，值 Mgmt2000 在本版本中已废弃，不再是有效值。 有关 SOAP 端点和不推荐使用的功能的详细信息，请参阅报表服务器 Web 服务端点和SQL Server 2012 的 SQL Server Reporting Services 中不推荐使用的功能。

-l   time_out

（可选）指定与服务器的连接超时之前等待的时间，以秒为单位。 默认值为 60 秒。 如果未指定超时值，则使用默认值。 0 值指定连接从不超时。

-b

（可选）指定脚本文件中的命令以批处理方式运行。 如有任何命令失败，则回滚批处理。 某些命令无法以批处理方式运行，这些命令将按常规方式运行。仅当脚本中产生异常并且未在脚本中得到处理时，才会导致回滚。 如果脚本处理了异常，并从 Main 正常返回，则将提交批处理。 如果省略此参数，则命令将不以批处理方式运行。 有关详细信息，请参阅批处理方法。

-v globalvar

（可选）指定脚本中使用的全局变量。 如果脚本使用全局变量，则必须指定此参数。 指定的值必须对 .rss 文件中定义的全局变量有效。必须为每个 –v 参数指定一个全局变量。

-v 参数在命令行上指定，可用来为运行时在脚本中定义的全局变量设置值。例如，如果脚本中包含一个名为 parentFolder 的变量，则可以在命令行上为该文件夹指定一个名称：

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

全局变量以给定的名称命名，并设置为提供的值。 例如， -v a="1" -v b="2" 将生成一个名为a 且值为“1”的变量，以及一个值为“2”的变量b。

全局变量可用于脚本中的所有函数。 反斜杠与英文引号连用 (\") 将转义为一个英文双引号。 仅当字符串中包含空格时才需要使用英文引号。 变量名必须对 Microsoft Visual Basic 有效；变量名必须以字母字符或下划线开头，并包含字母字符、数字或下划线。不能将保留字用作变量名。 有关使用全局变量的详细信息，请参阅表达式中的内置集合（报表生成器和 SSRS）。

-t

（可选）将错误信息输出到跟踪日志中。 此参数不带值。 有关详细信息，请参阅 报表服务器服务跟踪日志。

权限

若要运行该工具，必须拥有与运行脚本的报表服务器实例连接的权限。 可以运行脚本来更改本地计算机或远程计算机。 若要更改远程计算机上的报表服务器，请在-s 参数中指定远程计算机。

示例

以下示例说明了如何指定包含 Visual Basic .NET 脚本的脚本文件以及要执行的 Web 服务方法。

复制

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

有关其他示例，请参阅 运行 Reporting Services 脚本文件。

注释

可以定义脚本来设置系统属性，发布报表，等等。 所创建的脚本可以包含 Reporting Services API 的任何方法。 有关可以使用的方法和属性的详细信息，请参阅报表服务器 Web 服务。

必须用 Visual Basic .NET 代码编写脚本，并存储在文件扩展名为 .rss 的 Unicode 或 UTF-8 文本文件中。不能使用 rs 实用工具调试脚本。 若要调试脚本，请在 Microsoft Visual Studio 中运行代码。

请参阅

概念

运行 Reporting Services 脚本文件

为部署任务和管理任务编写脚本

报表服务器命令提示实用工具 (SSRS)

其他资源

使用 rs 实用工具和 Web 服务编写脚本