Script di esempio rs.exe di Reporting Services per la copia di contenuto tra server di report

Si applica a: SQL Server Reporting Services (2008 R2 e e versioni successive) SharePoint Server di report di Power BI

Questo articolo include e descrive uno script RSS di Reporting Services di esempio che copia elementi di contenuto e impostazioni da server di report SQL Server Reporting Services a un altro server di report tramite l'utilità RS.exe. RS.exe viene installato con Reporting Services, sia in modalità nativa che in modalità SharePoint. Lo script copia gli elementi di Reporting Services, ad esempio report e sottoscrizioni, da un server a un altro. Lo script supporta server di report in modalità nativa e in modalità SharePoint.

Scaricare lo script ssrs_migration.rss

Scaricare lo script dalla pagina Reporting Services RS.exe migration script (Script di migrazione RS.exe di Reporting Services) del sito GitHub in una cartella locale. Per altre informazioni, vedere la sezione Come usare lo script in questo articolo.

Scenari supportati

Lo script supporta server di report in modalità nativa e in modalità SharePoint. Lo script supporta le versioni di server di report SQL Server 2008 R2 (10.50.x) e successive e Server di report di Power BI.

Lo script può essere utilizzato per copiare il contenuto tra server di report nella stessa modalità o in modalità diverse. Ad esempio, è possibile eseguire lo script per copiare il contenuto da un server di report SQL Server 2008 R2 (10.50.x) in modalità nativa a un server di report SQL Server 2012 SP1 (11.0.3x) in modalità SharePoint. È possibile eseguire lo script da qualsiasi server in cui è installato RS.exe. Nella distribuzione seguente, ad esempio, è possibile:

• Eseguire RS.exe e lo script SUL Server A.

• Copiare il contenuto DAL Server B

• AL Server C

Per altre informazioni sull'utilità RS.exe, vedere Utilità RS.exe (SSRS).

Elementi e risorse di cui lo script esegue la migrazione

Lo script non sovrascrive elementi di contenuto esistenti con lo stesso nome. Se lo script rileva nel server di destinazione elementi presenti nel server di origine con lo stesso nome, viene visualizzato un messaggio di errore per i singoli elementi e lo script continua. Nella tabella seguente sono elencati i tipi di contenuto e risorse di cui lo script può eseguire la migrazione nelle modalità del server di report di destinazione.

Autorizzazioni necessarie

Le autorizzazioni necessarie per leggere o scrivere elementi e risorse non sono le stesse per tutti i metodi usati nello script. Nella tabella seguente sono riepilogati i metodi usati per ogni elemento o risorsa e vengono forniti collegamenti al contenuto correlato. Passare all'articolo specifico per visualizzare le autorizzazioni necessarie. Ad esempio nell'arricolo del metodo ListChildren sono indicate le autorizzazioni necessarie:

• Autorizzazioni necessarie per la modalità nativa: ReadProperties sull'elemento

• Autorizzazioni necessarie per la modalità SharePoint: ViewListItems

Per altre informazioni, vedere Confrontare ruoli e attività di Reporting Services con autorizzazioni e gruppi di SharePoint.

Come usare lo script

1. Scaricare il file script in una cartella locale, ad esempio c:\rss\ssrs_migration.rss.

2. Aprire un prompt dei comandi con privilegi amministrativi.

3. Passare alla cartella che contiene il file ssrs_migration.rss.

4. Eseguire il comando con i parametri appropriati per lo scenario di interesse.

Esempio di base, da server di report in modalità nativa a server di report in modalità nativa:

Nell'esempio seguente viene eseguita la migrazione del contenuto da Sourceserver in modalità nativa a Targetserverin modalità nativa.

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"

Note sull'utilizzo:

• Lo script viene eseguito in due passaggi.

  Il primo passaggio è un controllo, per la restituzione di un elenco di elementi di cui viene eseguita la migrazione, e il secondo passaggio è il processo di migrazione.

  È possibile annullare lo script dopo il primo passaggio se si desidera semplicemente visualizzare il possibile elenco di migrazione oppure modificare i parametri. Le impostazioni dipendenti non sono elencate nel primo passaggio. Ad esempio, non sono elencate le opzioni della cache di un report, ma è elencato il report stesso.

  Suggerimento

  Per controllare un singolo server, usare lo stesso server per l'origine e la destinazione e ignorare i passaggi successivi al passaggio 1.

  Per un utilizzo corretto delle informazioni di controllo del primo passaggio, esaminare i ruoli esistenti in entrambi i server in modalità nativa, quello di origine e quello di destinazione. Di seguito è riportato un esempio dell'elenco di controllo del primo passaggio. Si noti che l'elenco include una sezione dei ruoli, perché è stata usata l'opzione-v security="True":

  • 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 e TARGET_URL devono essere URL di server di report validi che fanno riferimento al server di report di Reporting Services di origine e di destinazione. In modalità nativa, l'URL di un server di report ha l'aspetto di questo URL:

  • https://servername/reportserver

  In modalità SharePoint l'URL ha l'aspetto di questo URL:

  • https://servername/_vti_bin/reportserver

• La struttura di cartelle virtuale presentata all'utente in SharePoint potrebbe essere diversa da quella sottostante. Aprire https://servername/_vti_bin/reportserver o https://servername/sites/site_name/_vti_bin/reportserver in un browser per vedere la struttura di cartelle non virtuale. Questa struttura è utile per impostare la cartella di origine e quella di destinazione su un valore diverso da /, per un server in modalità SharePoint.

• Per le password non viene eseguita la migrazione ed è necessario reimmetterle, ad esempio per origini dati con credenziali archiviate.

Descrizione del parametro

Altri esempi

Da server di report in modalità nativa a server di report in modalità nativa

Nell'esempio seguente viene eseguita la migrazione del contenuto da Sourceserver in modalità nativa a Targetserverin modalità nativa.

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"  

Nell'esempio seguente viene aggiunta l'opzione di sicurezza:

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"  

Da modalità nativa a modalità SharePoint - sito radice

Nell'esempio seguente viene eseguita la migrazione da un server SourceServer in modalità nativa al "sito radice" di un server TargetServer in modalità SharePoint. Viene eseguita la migrazione delle cartelle "Reports" e "Data Sources" del server in modalità nativa come nuove raccolte nella distribuzione di 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"  

Da modalità nativa a modalità SharePoint - raccolta siti "bi"

Nell'esempio seguente viene eseguita la migrazione del contenuto da un server in modalità nativa a un server SharePoint contenente una raccolta siti "sites/bi" e una raccolta di documenti condivisi. Lo script crea cartelle nella raccolta di documenti di destinazione. Ad esempio, lo script crea cartelle "Report" e "Origini dati" nella raccolta documenti di destinazione.

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"  

Da modalità SharePoint a modalità SharePoint - raccolta siti "bi"

Nell'esempio seguente viene eseguita la migrazione del contenuto:

• Da un server SourceServer SharePoint contenente una raccolta siti "sites/bi" e una raccolta di documenti condivisi.

• A un server TargetServer SharePoint contenente una raccolta siti "sites/bi" e una raccolta di documenti condivisi.

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"  

Da modalità nativa a modalità nativa - macchina virtuale di Azure

L'esempio seguente esegue la migrazione del contenuto da un server di report in modalità nativa SourceServer a un server di report in modalità nativa TargetServer in esecuzione su una macchina virtuale di Azure. TargetServer non viene unito al dominio di SourceServer e User2 è un amministratore di TargetServer nella macchina virtuale Azure.

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"  

Modalità SharePoint - raccolta siti "bi" in un server in modalità nativa su una macchina virtuale Azure.

Nell'esempio seguente viene eseguita la migrazione del contenuto da SourceServer un server di report in modalità SharePoint contenente una raccolta siti "sites/bi" e una raccolta di documenti condivisi a un server di report in modalità nativa TargetServer in esecuzione su una macchina virtuale Azure. TargetServer non viene unito al dominio di SourceServer e User2 è un amministratore di TargetServer nella macchina virtuale Azure.

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"  

Verifica

Nella sezione sono riepilogati alcuni passaggi da eseguire nel server di destinazione per verificare la corretta migrazione di contenuto e criteri.

Pianificazioni

Per verificare le pianificazioni nel server di destinazione:

Modalità nativa

1. Aprire il portale web nel server di destinazione.

2. Scegliere Impostazioni sito dal menu principale.

3. Nel riquadro sinistro selezionare Pianificazioni.

Modalità SharePoint:

1. Passare a Impostazioni sito.

2. Nel gruppo Reporting Services, selezionare Gestisci pianificazioni condivise.

Ruoli e gruppi

Modalità nativa

1. Aprire SQL Server Management Studio e connettersi al server di report in modalità nativa.

2. In Esplora oggetti, selezionare Sicurezza.

3. Selezionare Ruoli.

Risoluzione dei problemi

Usare il flag di traccia –t per ricevere altre informazioni. Ad esempio, se si esegue lo script e viene visualizzato un messaggio simile al seguente

• Impossibile connettersi al server: https://\<servername>/ReportServer/ReportService2010.asmx.

Eseguire nuovamente lo script con il flag –t per visualizzare un messaggio simile a questo:

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

Contenuto correlato

Utilità RS.exe (SSRS)
Confrontare ruoli e attività di Reporting Services con autorizzazioni e gruppi di SharePoint