Voorbeeldscript van Reporting Services rs.exe voor het kopiëren van inhoud tussen rapportservers

Van toepassing op: SQL Server Reporting Services (2008 R2 en latere versies) SharePoint Power BI Report Server

Dit artikel bevat en beschrijft een voorbeeld van een RSS-script van Reporting Services waarmee inhoudsitems en -instellingen van de ene SQL Server Reporting Services-rapportserver naar een andere rapportserver worden gekopieerd met behulp van het hulpprogrammaRS.exe . RS.exe is geïnstalleerd met Reporting Services, zowel systeemeigen als SharePoint-modus. Het script kopieert Reporting Services-items, bijvoorbeeld rapporten en abonnementen, van server naar een andere server. Het script ondersteunt rapportservers in zowel de SharePoint-modus als de systeemeigen modus.

Het ssrs_migration.rss-script downloaden

Download het script van de GitHub-site Reporting Services RS.exe migratiescript naar een lokale map. Zie de sectie Hoe u het script gebruikt in dit artikel voor meer informatie.

Ondersteunde scenario’s

Het script ondersteunt rapportservers in zowel de SharePoint-modus als de systeemeigen modus. Het script ondersteunt de rapportserverversies SQL Server 2008 R2 (10.50.x) en hoger en Power BI Report Server.

Het script kan worden gebruikt om inhoud tussen rapportservers van dezelfde modus of verschillende modi te kopiëren. U kunt bijvoorbeeld het script uitvoeren om inhoud te kopiëren van een rapportserver in de systeemeigen modus SQL Server 2008 R2 (10.50.x) naar een rapportserver in de SharePoint-modus sql Server 2012 SP1 (11.0.3x). U kunt het script uitvoeren vanaf elke server waarop RS.exe is geïnstalleerd. In de volgende implementatie kunt u bijvoorbeeld:

• Op Server A voert u RS.exe en het script uit.

• Inhoud van server B kopiëren

• AAN Server C

Zie RS.exe Utility (SSRS) voor meer informatie over het hulpprogramma RS.exe.

Items en bronnen die het script migreert

Het script schrijft niet over bestaande inhoudsitems met dezelfde naam. Als het script items detecteert met dezelfde naam op de doelserver die zich op de bronserver bevinden, resulteren de afzonderlijke items in een foutbericht en gaat het script verder. De volgende tabel toont de typen inhoud en resources die het script kan migreren naar de doelrapportservermodi.

Vereiste toestemmingen

De vereiste machtigingen voor het lezen of schrijven van items en resources zijn niet hetzelfde voor alle methoden die in het script worden gebruikt. De volgende tabel bevat een overzicht van de methoden die worden gebruikt voor elk item of elke resource en koppelingen naar gerelateerde inhoud. Navigeer naar het afzonderlijke artikel om de vereiste machtigingen te bekijken. Bijvoorbeeld, in het artikel over de ListChildren-methode worden de vereiste machtigingen vermeld.

• Vereiste machtigingen voor Native Mode: ReadProperties op Item

• Vereiste machtigingen voor SharePoint-modus: ViewListItems

Zie Rollen en taken in Reporting Services vergelijken met SharePoint-groepen en -machtigingen voor meer informatie.

Het script gebruiken

1. Download het scriptbestand naar een lokale map, bijvoorbeeld c:\rss\ssrs_migration.rss.

2. Open een opdrachtprompt met beheerdersbevoegdheden.

3. Navigeer naar de map met het ssrs_migration.rss-bestand.

4. Voer de opdracht uit met de parameters die geschikt zijn voor uw scenario.

Basisvoorbeeld: rapportserver in systeemeigen modus naar rapportserver in systeemeigen modus:

In het volgende voorbeeld wordt inhoud gemigreerd van de systeemeigen modus Sourceserver naar de systeemeigen modus 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"

Gebruiksnotities:

• Het script wordt in twee stappen uitgevoerd.

  De eerste stap is een controle, om een lijst met items te retourneren die worden gemigreerd en de tweede stap is het migratieproces.

  U kunt het script annuleren na stap 1 als u alleen de mogelijke migratielijst wilt zien of als u de parameters wilt wijzigen. Afhankelijke instellingen worden niet vermeld in stap 1. De cacheopties van een rapport worden bijvoorbeeld niet weergegeven, maar het rapport zelf.

  Aanbeveling

  Als u slechts één server wilt controleren, gebruikt u dezelfde server voor de bron en bestemming en annuleert u deze na stap 1.

  Een goed gebruik van de controlegegevens van stap 1 is het controleren van bestaande rollen op zowel de bron- als doelserver in de systeemeigen modus. In het volgende voorbeeld ziet u de auditlijst van stap 1. U ziet dat de lijst een sectie 'rollen' bevat omdat de switch-v security="True" is gebruikt:

  • 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

• De SOURCE_URL en TARGET_URL moeten geldige RAPPORTSERVER-URL's zijn die verwijzen naar de bron- en doelrapportserver van Reporting Services. In de systeemeigen modus ziet een RAPPORTserver-URL er als volgt uit:

  • https://servername/reportserver

  In de SharePoint-modus ziet de URL er als volgt uit:

  • https://servername/_vti_bin/reportserver

• De structuur van de virtuele mappen die aan de gebruiker in SharePoint wordt gepresenteerd, kan afwijken van de onderliggende mapstructuur. Open https://servername/_vti_bin/reportserver of https://servername/sites/site_name/_vti_bin/reportserver in een browser om de structuur van de niet-virtuele map weer te geven. Deze structuur is handig voor het instellen van de bronmap en doelmap op iets anders dan /, voor een server in de SharePoint-modus.

• Wachtwoorden worden niet gemigreerd en moeten opnieuw worden ingesteld, bijvoorbeeld gegevensbronnen met opgeslagen referenties.

Parameterbeschrijving

Meer voorbeelden

Rapportserver in systeemeigen modus naar rapportserver in systeemeigen modus

In het volgende voorbeeld wordt inhoud gemigreerd van de systeemeigen modus Sourceserver naar de systeemeigen modus 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"  

In het volgende voorbeeld wordt de beveiligingsswitch toegevoegd:

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"  

Systeemeigen modus naar SharePoint-modus - hoofdsite

In het volgende voorbeeld wordt inhoud gemigreerd van een systeemeigen modus SourceServer naar de hoofdsite op een SharePoint-modusserver TargetServer. De mappen Rapporten en Gegevensbronnen op de systeemeigen modusserver worden gemigreerd als nieuwe bibliotheken in de SharePoint-implementatie.

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"  

Systeemeigen modus voor SharePoint-modus -'bi' siteverzameling

In het volgende voorbeeld wordt inhoud van een systeemeigen modusserver gemigreerd naar een SharePoint-server die een siteverzameling van 'sites/bi' en een bibliotheek met gedeelde documenten bevat. Het script maakt mappen aan in de bestemmingsbibliotheek voor documenten. Met het script maakt u bijvoorbeeld een map Rapporten en een map Gegevensbronnen in de doeldocumentbibliotheek.

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 naar SharePoint-modus - 'bi' siteverzameling

In het volgende voorbeeld wordt inhoud gemigreerd:

• Van een SharePoint-server SourceServer die een siteverzameling "sites/bi" en een gedeelde documentbibliotheek bevat.

• Naar een TargetServer SharePoint-server die een siteverzameling van 'sites/bi' en een gedeelde documentbibliotheek bevat.

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"  

Systeemeigen modus naar systeemeigen modus - virtuele Azure-machine

In het volgende voorbeeld wordt inhoud gemigreerd van een Native mode rapportserver naar een Native mode rapportserver die draait op een virtuele Azure-machine. TargetServer is niet gekoppeld aan het domein van de SourceServer en User2 is een beheerder op de Azure virtuele machine 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' siteverzameling naar een systeemeigen modusserver op een virtuele Azure-machine.

In het volgende voorbeeld wordt inhoud gemigreerd van een SharePoint-modus rapportserver SourceServer, die een siteverzameling van 'sites/bi' en een bibliotheek voor gedeelde documenten bevat, naar een Natieve modus rapportserver die wordt uitgevoerd op een virtuele Azure-machine. TargetServer is niet gekoppeld aan het domein van de SourceServer en User2 is een beheerder op de Azure virtuele machine 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"  

Verification

De sectie bevat een overzicht van de stappen die u moet uitvoeren op de doelserver om te controleren of de inhoud en het beleid zijn gemigreerd.

Planningen

Schema's op de doelserver controleren:

Systeemeigen modus

1. Open de webportal op de doelserver.

2. Selecteer Site-instellingen in het bovenste menu.

3. Selecteer Planningen in het linkerdeelvenster.

SharePoint-modus:

1. Blader naar site-instellingen.

2. Selecteer Gedeelde planningen beheren in de Reporting Services-groep.

Rollen en groepen

Systeemeigen modus

1. Open SQL Server Management Studio en maak verbinding met uw rapportserver in de systeemeigen modus.

2. Selecteer Beveiliging in Objectverkenner.

3. Kies rollen.

Probleemoplossingsproces

Gebruik de traceringsvlag -t om meer informatie te ontvangen. Als u bijvoorbeeld het script uitvoert en een bericht ziet dat er ongeveer als volgt uitziet

• Kan geen verbinding maken met de server: https://\<servername>/ReportServer/ReportService2010.asmx

Voer het script opnieuw uit met de vlag -t om een bericht te zien dat vergelijkbaar is met deze:

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

Verwante inhoud

RS.exe hulpprogramma (SSRS)
Rollen en taken in Reporting Services vergelijken met SharePoint-groepen en -machtigingen