Reporting Services-Beispielskript für „rs.exe“ zum Kopieren von Inhalten zwischen Berichtsservern

Gilt für: SQL Server Reporting Services (2008 R2 und höher) SharePoint Power BI-Berichtsserver

Dieser Artikel enthält und beschreibt ein Beispiel für ein Reporting Services RSS-Skript, das mithilfe des Dienstprogramms RS.exe Inhaltselemente und Einstellungen von einem SQL Server Reporting Services-Berichtsserver auf einen anderen Berichtsserver kopiert. RS.exe wird mit Reporting Services installiert, sowohl im nativen als auch im SharePoint-Modus. Das Skript kopiert Reporting Services-Elemente, z.B. Berichte und Abonnements, von einem Server auf einen anderen Server. Das Skript unterstützt Berichtsserver im SharePoint-Modus und im einheitlichen Modus.

Herunterladen des Skripts „ssrs_migration.rss“

Laden Sie das Skript von der GitHub-Website Reporting Services RS.exe migration script (Reporting Services-Migrationsskript „RS.exe“) in einen lokalen Ordner herunter. Weitere Informationen finden Sie im Abschnitt So verwenden Sie das Skript.

Unterstützte Szenarios

Das Skript unterstützt Berichtsserver im SharePoint-Modus und im einheitlichen Modus. Das Skript unterstützt die Berichtsserverversionen SQL Server 2008 R2 (10.50.x) und höher sowie Power BI-Berichtsserver

Mit dem Skript können Inhalte zwischen Berichtsservern im gleichen Modus oder in unterschiedlichen Modi kopiert werden. Sie können das Skript beispielsweise ausführen, um Inhalte von einem SQL Server 2008 R2 10.50.x-Berichtsserver im nativen Modus auf einen SQL Server 2012 SP1 11.0.3x-Berichtsserver im SharePoint-Modus zu kopieren. Sie können das Skript auf jedem Server ausführen, auf dem RS.exe installiert ist. In der folgenden Bereitstellung haben Sie z. B. folgende Möglichkeiten:

• Führen Sie RS.exe und das Skript AUF Server A aus.

• So kopieren Sie Inhalte VON Server B

• AUF Server C

Weitere Informationen über das Dienstprogramm RS.exe finden Sie unter Dienstprogramm RS.exe (SSRS).

Vom Skript migrierte Elemente und Ressourcen

Das Skript überschreibt keine vorhandenen Inhaltselemente mit dem gleichen Namen. Wenn das Skript auf dem Zielserver Elemente mit dem gleichen Namen erkennt, die auch auf dem Quellserver vorhanden sind, führt dies zu einer Fehlermeldung für die einzelnen Elemente, und das Skript wird weiter ausgeführt. In der folgenden Tabelle werden die Typen von Inhalten und Ressourcen aufgeführt, die zu Zielberichtsservern in den jeweiligen Modi migriert werden können.

Erforderliche Berechtigungen

Die erforderlichen Berechtigungen zum Lesen oder Schreiben von Elementen und Ressourcen sind nicht für alle im Skript verwendeten Methoden gleich. Die folgende Tabelle enthält eine Übersicht über die für die einzelnen Elemente und Ressourcen verwendeten Methoden sowie Links zu verwandten Inhalten. Navigieren Sie zum jeweiligen Artikel, um die erforderlichen Berechtigungen anzuzeigen. Im Artikel zur ListChildren-Methode werden etwa die erforderlichen Berechtigungen aufgeführt:

• Erforderliche Berechtigungen für den einheitlichen Modus: ReadProperties für das Element

• Erforderliche Berechtigungen für den SharePoint-Modus: ViewListItems

Weitere Informationen finden Sie unter Vergleichen der Rollen und Aufgaben in Reporting Services mit SharePoint-Gruppen und -Berechtigungen.

Verwendung des Skripts

1. Laden Sie die Skriptdatei in einen lokalen Ordner herunter, z.B. C:\rss\ssrs_migration.rss.

2. Öffnen Sie eine Eingabeaufforderung mit Administratorberechtigungen.

3. Navigieren Sie zum Ordner, der die Datei ssrs_migration.rss enthält.

4. Führen Sie den Befehl mit für Ihr Szenario geeigneten Parametern aus.

Einfaches Beispiel, Berichtsserver im einheitlichen Modus zu Berichtsserver im einheitlichen Modus:

Im folgenden Beispiel werden Inhalte von Sourceserver im einheitlichen Modus zu Targetserverim einheitlichen Modus migriert.

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"

Hinweise zur Verwendung:

• Das Skript wird in zwei Schritten ausgeführt.

  Der erste Schritt besteht aus einer Überprüfung, mit der eine Liste der Elemente zurückgegeben wird, die migriert werden. Der zweite Schritt ist der Migrationsprozess.

  Sie können das Skript nach Schritt 1 abbrechen, wenn Sie nur die Liste der möglichen Migrationen anzeigen oder die Parameter ändern möchten. Abhängige Einstellungen werden in Schritt 1 nicht aufgeführt. Beispielsweise werden die Cacheoptionen eines Berichts nicht aufgeführt, der Bericht selbst wird jedoch aufgeführt.

  Tipp

  Wenn Sie nur einen einzelnen Server prüfen möchten, verwenden Sie denselben Server als Quelle und Ziel, und brechen Sie den Vorgang nach Schritt 1 ab.

  Eine gute Verwendung für die Überwachungsinformationen aus Schritt 1 besteht darin, vorhandene Rollen auf dem Quell- und Zielserver im einheitlichen Modus zu überprüfen. Das folgende Beispiel stellt die Überwachungsliste aus Schritt 1 dar. Beachten Sie, dass die Liste den Abschnitt „roles“ enthält, da der Schalter „-v security="True"“ verwendet wurde:

  • 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

• Die SOURCE_URL und TARGET_URL müssen gültige Berichtsserver-URLs sein, die auf den Quell- und Zielberichtsserver der Reporting Services verweisen. Berichtsserver-URL im einheitlichen Modus:

  • https://servername/reportserver

  Im SharePoint-Modus sieht die URL wie folgt aus:

  • https://servername/_vti_bin/reportserver

• Die virtuelle Ordnerstruktur, die für den Benutzer in SharePoint dargestellt wird, kann von der zugrunde liegenden Struktur abweichen. Öffnen Sie https://servername/_vti_bin/reportserver oder https://servername/sites/site_name/_vti_bin/reportserver in einem Browser, um die nicht virtuelle Ordnerstruktur anzuzeigen. Diese Struktur ist hilfreich, wenn der Quellordner und der Zielordner bei einem Server im SharePoint-Modus auf einen anderen Wert als / festgelegt werden sollen.

• Kennwörter werden nicht migriert und müssen erneut eingegeben werden, z. B. Datenquellen mit gespeicherten Anmeldedaten.

Parameterbeschreibung

Weitere Beispiele anzeigen

Berichtsserver im einheitlichen Modus zu Berichtsserver im einheitlichen Modus

Im folgenden Beispiel werden Inhalte von Sourceserver im einheitlichen Modus zu Targetserverim einheitlichen Modus migriert.

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"  

Im folgenden Beispiel wird der Sicherheitsschalter hinzugefügt:

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"  

Einheitlicher Modus zu SharePoint-Modus – Stammwebsite

Im folgenden Beispiel werden Inhalte von einem SourceServer im einheitlichen Modus zur „Stammwebsite“ auf einem Server im SharePoint-Modus (TargetServer) migriert. Die Ordner „Reports“ und „Data Sources“ auf dem Server im einheitlichen Modus werden als neue Bibliotheken für die SharePoint-Bereitstellung migriert.

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"  

Einheitlicher Modus zu SharePoint-Modus – „bi“-Websitesammlung

Im folgenden Beispiel werden Inhalte von einem Server im einheitlichen Modus zu einem SharePoint-Server migriert, der eine Websitesammlung "sites/bi" und eine freigegebene Dokumentbibliothek enthält. Das Skript erstellt Ordner in der Zieldokumentbibliothek. Das Skript erstellt z. B. einen Ordner „Reports“ und einen Ordner „Data Sources“ in der Zieldokumentbibliothek.

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-Modus zu SharePoint-Modus – „bi“-Websitesammlung

Im folgenden Beispiel werden Inhalte wie folgt migriert:

• Von dem SharePoint-Server SourceServer , der eine Websitesammlung „sites/bi“ und eine freigegebene Dokumentbibliothek enthält.

• Zu dem SharePoint-Server TargetServer , der eine Websitesammlung „sites/bi“ und eine freigegebene Dokumentbibliothek enthält.

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"  

Einheitlicher Modus zu einheitlichem Modus – virtueller Azure-Computer

Im folgenden Beispiel werden Inhalte von einem Berichtsserver im nativen Modus als SourceServer zu einem auf einer virtuellen Azure-Maschine ausgeführten Berichtsserver im nativen Modus als TargetServer migriert. Der TargetServer wird nicht in die Domäne von SourceServer eingebunden, und User2 ist Administrator auf dem virtuellen Azure-Computer 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-Modus – „bi“-Websitesammlung zu einem Server im einheitlichen Modus auf einem virtuellen Azure-Computer

Im folgenden Beispiel werden Inhalte von einem Berichtsserver im SharePoint-Modus als SourceServer, der eine Websitesammlung „sites/bi“ und eine freigegebene Dokumentbibliothek enthält, zu einem auf einem virtuellen Azure-Computer ausgeführten Berichtsserver im nativen Modus als TargetServer migriert. Der TargetServer wird nicht in die Domäne von SourceServer eingebunden, und User2 ist Administrator auf dem virtuellen Azure-Computer 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"  

Überprüfung

In diesem Abschnitt werden einige Schritte zusammengefasst, die auf dem Zielserver ausgeführt werden müssen, um zu überprüfen, ob Inhalte und Richtlinien erfolgreich migriert wurden.

Zeitpläne

So überprüfen Sie Zeitpläne auf dem Zielserver:

Native Mode

1. Öffnen Sie das Webportal auf dem Zielserver.

2. Klicken Sie im oberen Menü auf Siteeinstellungen.

3. Klicken Sie im linken Bereich auf Zeitpläne.

SharePoint-Modus:

1. Rufen Sie Siteeinstellungenauf.

2. Wählen Sie in der Gruppe Reporting Services die Option Freigegebene Zeitpläne verwalten aus.

Rollen und Gruppen

Native Mode

1. Öffnen Sie SQL Server Management Studio und stellen Sie eine Verbindung zu Ihrem Berichtsserver im nativen Modus her.

2. Wählen Sie im Objekt-Explorer die Option Sicherheit aus.

3. Wählen Sie Rollen aus.

Problembehandlung

Verwenden Sie das Ablaufverfolgungsflag -t, um weitere Informationen abzurufen. Beispiel: Sie führen das Skript aus, und es wird eine Meldung wie die folgende angezeigt:

• Serververbindung konnte nicht hergestellt werden: https://\<servername>/ReportServer/ReportService2010.asmx

Führen Sie das Skript mit dem Flag -t erneut aus. Es wird eine Meldung wie diese angezeigt:

• 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 ---

Zugehöriger Inhalt

Hilfsprogramm RS.exe (SSRS)
Vergleichen der Rollen und Aufgaben in Reporting Services mit SharePoint-Gruppen und -Berechtigungen