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

Reporting Services 支持使用脚本来自动执行日常安装、部署任务和管理任务。 部署报表服务器的过程包括多个步骤。 必须使用多个工具和过程来配置部署;没有任何单个程序或方法可用于自动执行所有任务。

并非每个步骤都应自动执行。 在某些情况下,手动或通过图形工具执行步骤是最简单且最有效的方法。 例如,如果要部署大量报表和模型,最好复制报表服务器数据库,而不是编写用于重新创建报表服务器环境的代码。

某些步骤需要自定义代码。 例如,可以自动为 Web 服务和报表管理器配置 URL,但是只有在编写用于对报表服务器 Windows Management Instrumentation (WMI) 提供程序进行调用的自定义代码时才能这样做。 如果不想编写代码,则必须使用 Reporting Services 配置工具执行该步骤。

若要运行配置报表服务器的脚本,您必须是要配置的计算机上的本地管理员。 有关详细信息,请参阅 配置报表服务器以进行远程管理

本主题说明自动执行特定步骤的推荐方法。 介绍了几个程序和编程接口,本主题的稍后部分中提供了针对每一种方法的说明。

部署任务及自动执行这些任务的方式

下表总结了部署报表服务器所需的安装和配置任务。 您可以使用该表将特定任务与用于自动执行任务或在无人参与的情况下执行任务的方法相匹配。

任务 方法
安装 Reporting Services。 可以从命令行运行安装程序以执行无人参与的安装。

可以使用安装程序安装和配置报表服务器,但是只有在指定默认配置选项且系统满足此安装类型的所有要求时才能这样做。 如果不能安装默认配置,则必须执行“仅文件”安装。
配置服务帐户。 服务帐户最初是在安装过程中配置的。 若要将更改服务帐户作为安装后任务自动执行,必须编写可对报表服务器 WMI 接口进行调用的自定义代码。 没有用于以编程方式配置服务帐户的命令提示实用工具或脚本模板。

如果编码要求阻止您自动执行此步骤,则可通过运行 Reporting Services 配置工具轻松地手动配置帐户。 有关详细信息,请参阅 (SSRS Configuration Manager) 配置服务帐户
配置报表服务器 Web 服务和报表管理器 URL。 必须编写用于对报表服务器 WMI 提供程序进行调用的自定义代码。 没有用来配置 URL 的命令行实用工具或脚本模板。

如果希望避免编写代码,则可以通过运行 Reporting Services 配置工具来手动配置 URL。 有关详细信息,请参阅配置 (SSRS Configuration Manager) URL
创建报表服务器数据库。 必须编写用于对报表服务器 WMI 提供程序进行调用的自定义代码。 没有用来创建报表服务器数据库和 RSExecRole 的命令提示实用工具或脚本模板。

如果希望避免编写代码,则可以通过运行 Reporting Services 配置工具来手动创建数据库。 有关详细信息,请参阅创建本机模式报表服务器数据库 (SSRS Configuration Manager)
配置报表服务器数据库连接。 如果要更改连接字符串、帐户、密码或身份验证类型,请通过运行 rsconfig 实用工具来配置连接。 有关详细信息,请参阅配置报表服务器数据库连接 (SSRS Configuration Manager) rsconfig 实用工具 (SSRS)

不能使用 rsconfig.exe 来创建或升级数据库。 数据库和 RSExecRole 必须已经存在。
配置扩展部署。 从以下用于自动执行扩展部署的方法中进行选择:

运行 rskeymgmt.exe 实用工具以将报表服务器实例联接到现有安装。 有关详细信息,请参阅为 Scale-Out 部署添加和删除加密密钥 (SSRS Configuration Manager)

编写针对报表服务器 WMI 提供程序运行的自定义代码。
备份加密密钥。 从以下用于自动备份加密密钥的方法中进行选择:

运行 rskeymgmt.exe 实用工具以备份密钥。 有关详细信息,请参阅 Back Up and Restore Reporting Services Encryption Keys

编写针对报表服务器 WMI 提供程序运行的自定义代码。
配置报表服务器电子邮件。 编写针对 Reporting Services WMI 提供程序运行的自定义代码。 该提供程序支持部分电子邮件配置设置。

虽然 RSReportServer.config 文件包含所有设置,但是不要以自动执行的方式使用该文件。 具体来说,不要使用批处理文件将该文件复制到另一个报表服务器。 每个配置文件都包含特定于当前实例的值。 这些值对于其他报表服务器实例将是无效的。

若要详细了解设置,请参阅为报表服务器配置电子邮件传递(SSRS 配置管理器)
配置无人参与的执行帐户。 从以下用于自动配置无人参与处理帐户的方法中进行选择:

运行 rsconfig.exe 实用工具以配置帐户。 有关详细信息,请参阅配置无人参与的执行帐户 (SSRS Configuration Manager)

编写用于对报表服务器 WMI 提供程序进行调用的自定义代码。
将现有的内容(包括文件夹层次结构、角色分配、报表、订阅、计划、数据源和资源)部署到另一台报表服务器上。 重新创建现有报表服务器环境的最佳方式是将报表服务器数据库复制到新的报表服务器实例中。

替代方法是编写自定义代码,以编程方式重新创建现有的报表服务器内容。 但应注意,订阅、报表快照和报表历史记录无法以编程方式重新创建。

某些部署受益于以上两项技术的结合使用(也就是说,还原报表服务器数据库,然后运行自定义代码以便为特定安装修改报表服务器数据库)。

有关详细示例,请参阅 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers

有关重新定位报表服务器数据库的详细信息,请参阅将报表服务器数据库至其他计算机(SSRS 本机模式)。 有关以编程方式创建报表服务器环境的详细信息,请参阅本主题中的“使用脚本迁移报表服务器内容和文件夹”一节。

用于自动执行服务器部署的工具和技术

以下列表总结了可用于自动执行部署和维护任务的程序和接口:

  • 可以在无人参与模式下运行安装程序,以安装和配置(有时)报表服务器组件。 必须使用“仅文件”安装选项,才能让安装程序配置报表服务器实例。

  • Reporting Services WMI 提供程序和 Reporting Services 命令行实用工具可用于本地和远程服务器配置。

    Reporting Services WMI 提供程序公开了用于对 Reporting Services 安装的各个方面(包括指定服务帐户、配置 URL、创建和配置报表服务器数据库或者为电子邮件传递配置报表服务器)进行配置的类、属性和方法。 必须编写自定义代码或脚本,才能使用 WMI 提供程序。 有关详细信息,请参阅 访问 Reporting Services WMI 提供程序

    除了编写代码以外,还可以使用命令行实用工具(rsconfig.exe 和 rskeymgmt.exe)。 可以编写运行实用工具的批处理文件。 可以使用实用工具来自动执行某些但不是所有配置任务。

  • 报表服务器脚本主机工具 (rs.exe) 可以运行为了重新创建现有内容或将现有内容从一个报表服务器移至另一个报表服务器而编写的自定义 Microsoft Visual Basic 代码。 使用此方法,可以在 Visual Basic中编写脚本,将其另存为 .rss 文件,并使用 rs.exe 在目标报表服务器上运行该脚本。 所编写的脚本可以调用 SOAP 接口,以访问报表服务器 Web 服务。 应使用此方法编写部署脚本,因为通过此方法可以重新创建报表服务器文件夹命名空间和内容,以及重新创建基于角色的安全性。

  • SQL Server 2014 版本引入了适用于 SharePoint 集成模式的 PowerShell cmdlet。 您可以使用 PowerShell 配置和管理 SharePoint 集成。 有关详细信息,请参阅 用于 Reporting Services SharePoint 模式的 PowerShell cmdlet

使用脚本迁移报表服务器内容和文件夹

可以编写用于在其他报表服务器实例中复制报表服务器环境的脚本。 通常会使用 Visual Basic 编写部署脚本,然后使用报表服务器脚本主机实用工具处理这些脚本。

有关详细示例,请参阅 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers

使用脚本可以在服务器之间复制文件夹、共享数据源、资源、报表、角色分配和设置。 为报表服务器实例编写脚本,然后在其他服务器上运行该脚本以重新创建报表服务器命名空间。 如果在 Reporting Services 部署中有多个报表服务器,则可以在每台服务器上分别运行该脚本,以便通过同一种方式配置所有的服务器。

下面是在服务器之间迁移报表的步骤:

  1. 将脚本变量设置为源报表服务器的 URL。

  2. 使用 GetItemDefinitionGetProperties 方法检索报表定义和报表的属性。

  3. 将 URL 设置为指向目标服务器。

  4. 使用 CreateCatalogItem 方法,传递从 GetProperties 返回的属性和由 GetItemDefinition

通过结合使用 get 方法和 create 方法,您可以执行类似的步骤以迁移设置、文件夹、共享数据源和资源。 有关可用方法的详细信息,请参阅技术参考 (SSRS)

注意

除非已显示设置凭据,否则脚本将使用运行脚本的用户的 Microsoft Windows 凭据运行。

有关如何设置格式并运行脚本文件的详细信息,请参阅 使用 rs.exe 实用工具和 Web 服务编写脚本

使用脚本设置服务器属性

可以编写脚本以针对报表服务器设置系统属性。 下面的 Visual Basic .NET 脚本显示了一种设置属性的方法。 该示例禁用了 RSClientPrint ActiveX 控件,但可以用任意有效的属性名称和值来替换 EnableClientPrintingFalse。 若要查看服务器属性的完整列表,请参阅 Report Server System Properties

若要使用该脚本,则将其保存至扩展名为 .rss 的文件,然后使用 rs.exe 命令提示实用工具在报表服务器上运行该文件。 由于没有编译该脚本,因此不需要安装 Visual Basic。 该示例假定您对承载报表服务器的本地计算机拥有权限。 如果未使用拥有权限的帐户进行登录,则必须通过其他命令行参数来指定帐户信息。 有关详细信息,请参阅 RS.exe 实用工具 (SSRS)

Public Sub Main()  
        Dim props(0) As [Property]  
        Dim setProp As New [Property]  
        setProp.Name = "EnableClientPrinting"  
        setProp.Value = "False"   
        props(0) = setProp  
        Try  
            rs.SetSystemProperties(props)  
        Catch ex As System.Web.Services.Protocols.SoapException  
            Console.Write(ex.Detail.InnerXml)  
        Catch e as Exception  
            Console.Write(e.Message)  
        End Try  
End Sub  

另请参阅

GenerateDatabaseCreationScript 方法 (WMI MSReportServer_ConfigurationSetting)
GenerateDatabaseRightsScript 方法 (WMI MSReportServer_ConfigurationSetting)
GenerateDatabaseUpgradeScript 方法 (WMI MSReportServer_ConfigurationSetting)
Install SQL Server 2014 from the Command Prompt
安装 Reporting Services 本机模式报表服务器
Reporting Services 报表服务器(本机模式)
报表服务器命令提示实用工具 (SSRS)
规划 Reporting Services 和 Power View 浏览器支持 (Reporting Services 2014)
Reporting Services 工具