レポート サーバー間でコンテンツをコピーするサンプル Reporting Services rs.exe スクリプト

適用対象: SQL Server Reporting Services (2008 R2 以降) SharePoint Power BI Report Server

この記事では、RS.exe ユーティリティを使用してコンテンツのアイテムと設定を SQL Server Reporting Services レポート サーバー間でコピーする、サンプル Reporting Services RSS スクリプトについて説明します。 RS.exe は、ネイティブと SharePoint モードの両方で、Reporting Services と共にインストールされます。 このスクリプトは、Reporting Services アイテム (レポートやサブスクリプションなど) をサーバー間でコピーします。 スクリプトは SharePoint モードとネイティブ モードの両方のレポート サーバーをサポートしています。

ssrs_migration.rss スクリプトをダウンロードする

GitHub サイト「Reporting Services RS.exe migration script」 (Reporting Services RS.exe 移行スクリプト) からスクリプトをローカル フォルダーにダウンロードします。 詳細については、この記事内の「スクリプトの使用方法」をご覧ください。

サポートされるシナリオ

スクリプトは SharePoint モードとネイティブ モードの両方のレポート サーバーをサポートしています。 スクリプトは、レポート サーバー バージョン SQL Server 2008 R2 (10.50.x) 以降と、Power BI Report Server をサポートしています。

スクリプトは同じモードまたは異なるモードのレポート サーバー間でコンテンツをコピーするために使用できます。 たとえば、スクリプトを実行して SQL Server 2008 R2 (10.50.x) ネイティブ モード レポート サーバーから SQL Server 2012 SP1 (11.0.3x) SharePoint モード レポート サーバーにコンテンツをコピーできます。 スクリプトは RS.exe がインストールされているいずれのサーバーからも実行できます。 たとえば、以下の配置では次のことが可能です。

• サーバー A 上で RS.exe とスクリプトを実行する

• サーバー B から コンテンツを

• サーバー Cに コピーする

RS.exe ユーティリティの詳細については、「RS.exe ユーティリティ (SSRS)」をご覧ください。

スクリプトが移行するアイテムとリソース

スクリプトは同じ名前の既存のコンテンツ アイテムを上書きしません。 スクリプトが移行元サーバー上のアイテムと同じ名前のアイテムを移行先サーバーで検出した場合、個々のアイテムについて "FAILURE" メッセージが表示されますが、スクリプトは続行されます。 次の表は、スクリプトを使用して移行先のモードのレポート サーバーに移行できるコンテンツとリソースの種類を示したものです。

必要なアクセス許可

アイテムやリソースの読み書きに必要なアクセス許可は、スクリプトで使用されるすべてのメソッドで同じではありません。 次の表は、各アイテムまたはリソースに使用するメソッドをまとめたもので、各メソッドはそれぞれ関連するコンテンツにリンクされています。 必要な権限を確認するには、個々の記事に移動してください。 たとえば、ListChildren メソッドの記事では、必要なアクセス許可が次のように示されています。

• ネイティブ モードで必要な権限: アイテムに対する ReadProperties

• SharePoint モードで必要な権限: ViewListItems

詳細については、「Reporting Services のロールおよびタスクと SharePoint グループおよびアクセス許可の比較」を参照してください。

スクリプトの使用方法

1. スクリプト ファイルをローカル フォルダー (c: \rss\ssrs_migration.rssなど) にダウンロードします。

2. 管理者特権を使用してコマンド プロンプトを開きます。

3. ssrs_migration.rss ファイルのあるフォルダーに移動します。

4. シナリオに適したパラメーターを指定してコマンドを実行します。

基本的な例 (ネイティブ モード レポート サーバー間):

次の例では、ネイティブ モード Sourceserver からネイティブ モード Targetserverにコンテンツを移行します。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"

使用に関するメモ:

• スクリプトは 2 つのステップで実行されます。

  最初のステップは監査です。移行されるアイテムのリストが返されます。2 番目のステップは移行です。

  移行されるアイテムを一覧表示するのみ、またはパラメーターを変更するのみの場合は、最初の ステップの後にスクリプトをキャンセル できます。 依存設定は最初のステップで一覧表示されません。 たとえば、レポートのキャッシュ オプションは一覧表示されません。ただし、レポート自体は一覧表示されます。

  ヒント

  単に 1 つのサーバーを監査する場合は、移行元および移行先として同じサーバーを使用し、ステップ 1 の後にキャンセルしてください。

  最初のステップで一覧表示される監査情報は、移行元と移行先の両方のネイティブ モード サーバー上の既存のロールを確認するために役立ちます。 次に示しているのは、最初のステップである監査で表示される一覧の例です。 スイッチ -v security="True" を使用したため、一覧に "roles" セクションが含まれています。

  • Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

    Retrieving roles:

    Role: Browser

    Role: Content Manager

    Role: Model Item Browser

    Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

    Retrieving roles:

    Role: Browser

    Role: Content Manager

    Role: CustomRole

    Role: Model Item Browser

    Role: My Reports

    Role: Publisher

    Role: Report Builder

    Role: System Administrator

    Role: System User

    Retrieving system policies:

    Retrieving system policies:

    System policy: BUILTIN\Administrators

    System policy: domain\user1

    System policy: domain\ueser2

    Retrieving schedules:

    Schedule: theMondaySchedule

    Retrieving catalog items. This may take a while.

    Folder: /Data Sources

    DataSource: /Data Sources/Aworks2012_oltp

    Folder: /images

    Resource: /images/Boba Fett.png

    Resource: /images/R2-D2.png

    Folder: /Reports

    Report: /Reports/products

    Report: /Reports/test

    Report: /Reports/TitleOnly

• SOURCE_URL と TARGET_URL は、移行元と移行先の Reporting Services レポート サーバーを参照する有効なレポート サーバー URL であることが必要です。 ネイティブ モードでは、レポート サーバー URL はこの URL のようになります。

  • https://servername/reportserver

  SharePoint モードでは、URL は次の URL のようになります。

  • https://servername/_vti_bin/reportserver

• SharePoint でユーザーに表示される仮想フォルダー構造は、基になっている構造と異なる場合があります。 ブラウザーで https://servername/_vti_bin/reportserver または https://servername/sites/site_name/_vti_bin/reportserver を開き、非仮想フォルダー構造を確認してください。 この構造は、SharePoint モード サーバーの移行元フォルダーと移行先フォルダーを / 以外に設定するために役立ちます。

• パスワードは移行されないため、再入力する必要があります。たとえば、保存された資格情報を使用するデータ ソースなどです。

パラメーターの説明

その他の例

ネイティブ モード レポート サーバーからネイティブ モード レポート サーバー

次の例では、ネイティブ モード Sourceserver からネイティブ モード Targetserverにコンテンツを移行します。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"  

次の例では、security スイッチを追加します。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password" -v security="True"  

ネイティブ モードから SharePoint モード (ルート サイト)

次の例では、ネイティブ モード SourceServer から SharePoint モード サーバー TargetServer上の "ルート サイト" にコンテンツを移行します。 ネイティブ モード サーバー上の "Reports" および "Data Sources" フォルダーは SharePoint 配置上の新しいライブラリとして移行されます。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p Password -v ts="https://TargetServer/_vti_bin/ReportServer" -v tu="Domain\User" -v tp="Password"  

ネイティブ モードから SharePoint モード ("bi" サイト コレクション)

次の例では、ネイティブ モード サーバーから、"sites/bi" サイト コレクションおよび共有ドキュメント ライブラリを含む SharePoint サーバーにコンテンツを移行します。 スクリプトは移行先ドキュメント ライブラリ内にフォルダーを作成します。 たとえば、移行先ドキュメント ライブラリ内に "Reports" フォルダ―および "Data Sources" フォルダーを作成します。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p Password -v ts="https://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"  

SharePoint モードから SharePoint モード ("bi" サイト コレクション)

この例では、次のようにコンテンツを移行します。

• "sites/bi" サイト コレクションおよび共有ドキュメント ライブラリを含む SharePoint サーバー SourceServer から。

• "sites/bi" サイト コレクションおよび共有ドキュメント ライブラリを含む SharePoint サーバー TargetServer に。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/_vti_bin/reportserver -v st="sites/bi" -v f="Shared Documents" -u Domain\User1 -p Password -v ts="https://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"  

ネイティブ モードからネイティブ モード (Azure 仮想マシン)

次の例では、ネイティブ モードのレポート サーバー SourceServer から、Azure 仮想マシンで実行されている TargetServer ネイティブ モードのレポート サーバーにコンテンツを移行します。 TargetServer は SourceServer のドメインに参加していません。User2 は Azure 仮想マシン TargetServer の管理者です。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\user1 -p Password -v ts="https://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Password2"  

SharePoint モード ("bi" サイト コレクションから Azure 仮想マシン上のネイティブ モード サーバー)

次の例では、SharePoint モードのレポート サーバー の SourceServer ("sites/bi" のサイト コレクションおよび共有ドキュメント ライブラリを含む) から TargetServer (Azure 仮想マシンで実行されているネイティブ モードのレポート サーバー) にコンテンツを移行します。 TargetServer は SourceServer のドメインに参加していません。User2 は Azure 仮想マシン TargetServer の管理者です。

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://uetesta02/_vti_bin/reportserver -u user1 -p Password -v ts="https://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Passowrd2"  

検証

このセクションは、コンテンツとポリシーが正常に移行されたことを確認するために移行先サーバーで実行する一部の手順をまとめたものです。

スケジュール

ターゲット サーバーでスケジュールを確認するには:

Native Mode

1. 移行先サーバー上で Web ポータルを開きます。

2. トップ メニューの [サイトの設定] を選択します。

3. 左側のウィンドウで [スケジュール] を選択します。

SharePoint モード:

1. [サイトの設定] を参照します。

2. [Reporting Services] グループで、[共有スケジュールの管理] を選択します。

役割とグループ

Native Mode

1. SQL Server Management Studio を開き、ネイティブ モード レポート サーバーに接続します。

2. オブジェクト エクスプローラーで [セキュリティ] を選択します。

3. [役割] を選びます。

トラブルシューティング

より詳細な情報が表示されるようにするには、トレース フラグ -t を使用します。 たとえば、スクリプトを実行し、次のようなメッセージが表示されたとします。

• サーバー https://\<servername>/ReportServer/ReportService2010.asmx に接続できませんでした

-t フラグを指定してスクリプトをもう一度実行すると、次のようなメッセージが表示されます。

• System.Exception: Couldn't connect to server: https://\<servername>/ReportServer/ReportService2010.asmx ---> System.Net.WebException: **The request failed with HTTP status 401: Unauthorized**. at System.Web.Services.Protocols.SoapHttpClientProtocol.ReadResponse(SoapClientMessage message, WebResponse response, Stream responseStream, Boolean asyncCall) at System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(String methodName, Object[] parameters) at Microsoft.SqlServer.ReportingServices2010.ReportingService2010.IsSSLRequired() at Microsoft.ReportingServices.ScriptHost.Management2010Endpoint.PingService(String url, String userName, String password, String domain, Int32 timeout) at Microsoft.ReportingServices.ScriptHost.ScriptHost.DetermineServerUrlSecurity() --- End of inner exception stack trace ---

関連するコンテンツ

RS.exe ユーティリティ (SSRS)
Reporting Services のロールおよびタスクと SharePoint のグループおよび権限の比較