Exemplo de script rs.exe dos Serviços de Relatórios para copiar conteúdo entre servidores de relatórios

Aplica-se a: SQL Server Reporting Services (2008 R2 e versões posteriores) SharePoint Power BI Report Server

Este artigo inclui e descreve um exemplo de script RSS dos Serviços de Relatórios que copia itens de conteúdo e definições de um servidor de relatórios dos Serviços de Relatórios SQL Server para outro servidor de relatórios, utilizando a utilidade RS.exe . RS.exe está instalado com Serviços de Relatório, tanto em modo nativo como em modo SharePoint. O script copia itens dos Serviços de Relatório, por exemplo relatórios e subscrições, de um servidor para outro servidor. O script suporta tanto servidores de relatórios em modo SharePoint como em modo nativo.

Descarregue o script ssrs_migration.rss

Descarregue o script Reporting Services RS.exe migration script do site GitHub para uma pasta local. Para mais informações, consulte a secção Como usar o guião neste artigo.

Cenários suportados

O script suporta tanto servidores de relatórios em modo SharePoint como em modo nativo. O script suporta as versões do servidor de relatórios SQL Server 2008 R2 (10.50.x) e posteriores, e o Power BI Report Server.

O script pode ser usado para copiar conteúdo entre servidores de relatório do mesmo modo ou de modos diferentes. Por exemplo, pode executar o script para copiar conteúdo de um servidor de relatórios em modo nativo SQL Server 2008 R2 (10.50.x) para um servidor de relatórios SQL Server 2012 SP1 (11.0.3x) em modo SharePoint. Podes executar o script a partir de qualquer servidor onde RS.exe esteja instalado. Por exemplo, na seguinte implementação, você pode:

• Executa RS.exe e o script NO Servidor A.

• Para copiar conteúdo DO Servidor B

• PARA Servidor C

Para mais informações sobre a RS.exe utilidade, consulte RS.exe Utilidade (SSRS).

Itens e recursos que o script migra

O script não sobrescreve o conteúdo existente com o mesmo nome. Se o script detetar itens com o mesmo nome no servidor de destino que estejam no servidor de origem, os itens individuais resultam numa mensagem de "falha" e o script continua. A tabela seguinte lista os tipos de conteúdo e recursos que o script pode migrar para modos de servidor de relatórios de destino.

Permissões necessárias

As permissões necessárias para ler ou escrever itens e recursos não são as mesmas para todos os métodos usados no script. A tabela seguinte resume os métodos usados para cada item ou recurso e liga para conteúdos relacionados. Navegue até ao artigo individual para ver as permissões necessárias. Por exemplo, o artigo do método ListChildren refere as permissões necessárias de:

• Permissões Necessárias no Modo Nativo: ReadProperties no Item

• Permissões Necessárias no Modo SharePoint: ViewListItems

Para mais informações, consulte Comparar funções e tarefas nos Serviços de Relatórios com grupos SharePoint e permissões.

Como usar o script

1. Descarregue o ficheiro de script para uma pasta local, por exemplo c:\rss\ssrs_migration.rss.

2. Abra uma linha de comandos com privilégios administrativos.

3. Navegue até à pasta que contém o ficheiro ssrs_migration.rss.

4. Executa o comando com os parâmetros adequados ao teu cenário.

Exemplo básico: servidor de relatórios em modo nativo para servidor de relatórios em modo nativo:

O exemplo seguinte migra conteúdo do Sourceserver em modo nativo para o Targetserver em modo nativo.

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"

Notas de utilização:

• O script corre em dois passos.

  O primeiro passo é uma auditoria, para devolver uma lista dos itens que foram migrados, e o segundo passo é o processo de migração.

  Podes cancelar o script após o passo 1 se só quiseres ver a lista de migração possível ou se quiseres modificar os parâmetros. As definições dependentes não estão listadas no passo 1. Por exemplo, as opções de cache de um relatório não estão listadas, mas o próprio relatório está.

  Sugestão

  Se quiseres auditar apenas um único servidor, usa o mesmo servidor para origem e destino e cancela após o passo 1.

  Uma boa utilização da informação da auditoria do passo 1 é rever os papéis existentes tanto no servidor nativo de origem como no de destino. O exemplo seguinte mostra a lista de auditoria do passo 1. Note que a lista inclui uma secção de "funções" devido à utilização do switch-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

• O SOURCE_URL e o TARGET_URL devem ser URLs válidos do servidor de relatórios que apontem para o servidor de relatórios dos Serviços de Relatórios de origem e destino. No modo nativo, uma URL de servidor de relatórios assemelha-se a esta URL:

  • https://servername/reportserver

  No modo SharePoint, o URL parece-se com este:

  • https://servername/_vti_bin/reportserver

• A estrutura de pastas virtuais apresentada ao utilizador no SharePoint pode ser diferente da estrutura subjacente. Abre https://servername/_vti_bin/reportserver ou https://servername/sites/site_name/_vti_bin/reportserver num navegador para ver a estrutura de pastas não virtual. Esta estrutura é útil para definir a pasta de origem e a pasta de destino para algo diferente de /, para um servidor em modo SharePoint.

• As palavras-passe não são migradas e têm de ser reintroduzidas, por exemplo fontes de dados com credenciais armazenadas.

Descrição do parâmetro

Mais exemplos

Servidor de relatórios em modo nativo para servidor de relatórios em modo nativo

O exemplo seguinte migra conteúdo do Sourceserver em modo nativo para o Targetserver em modo nativo.

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"  

O exemplo seguinte adiciona o interruptor de segurança:

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"  

Modo Nativo para modo SharePoint - Site Raiz

O exemplo seguinte migra conteúdo de um SourceServer em modo nativo para o "site raiz" num servidor TargetServer em modo SharePoint. As pastas "Relatórios" e "Fontes de Dados" no servidor de modo nativo são migradas como novas bibliotecas na implementação do 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"  

Modo nativo para modo SharePoint - colecção de sites 'bi'

O exemplo seguinte migra conteúdo de um servidor em modo nativo para um servidor SharePoint que contém uma coleção de sites "sites/bi" e uma biblioteca de documentos partilhados. O script cria pastas na biblioteca de destino. Por exemplo, o script cria uma pasta "Reports" e uma pasta "Data Sources" na biblioteca de documentos de destino.

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"  

De Modo SharePoint para Modo SharePoint - coleção de sites BI

O exemplo seguinte migra conteúdo:

• A partir de um servidor SharePoint SourceServer que contém uma coleção de sites em "sites/bi" e uma biblioteca de documentos partilhados.

• Para um servidor TargetServer do SharePoint que contém uma coleção de sites denominada "sites/bi" e uma biblioteca de documentos partilhados.

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"  

Modo nativo a modo nativo - Máquina virtual da Azure

O exemplo seguinte migra conteúdo de um servidor de relatórios em modo nativo SourceServer para um servidor de relatórios nativo TargetServer a correr numa máquina virtual Azure. O TargetServer não está ligado ao domínio do SourceServer e o User2 é um administrador na máquina virtual 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"  

Modo SharePoint - coleção de sites 'BI' num servidor em modo nativo numa Azure Virtual Machine.

O exemplo seguinte migra conteúdo de um servidor de relatórios em modo SharePoint SourceServer que contém uma coleção de sites de "sites/bi" e uma biblioteca de documentos partilhados para um servidor de relatórios em modo Nativo TargetServer a correr numa máquina virtual no Azure. O TargetServer não está ligado ao domínio do SourceServer e o User2 é um administrador na máquina virtual 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"  

Verification

A secção resume alguns dos passos a seguir no servidor de destino para verificar se o conteúdo e as políticas foram migrados com sucesso.

Horários

Para verificar os horários no servidor alvo:

Modo Nativo

1. Abra o portal web no servidor de destino.

2. Selecione Definições do Site no menu superior.

3. Selecione Horários no painel esquerdo.

Modo SharePoint:

1. Navegar até Definições do Site.

2. No grupo de Serviços de Relatório , selecione Gerir Agendamentos Partilhados.

Funções e grupos

Modo Nativo

1. Abre o SQL Server Management Studio e liga-te ao teu servidor de relatórios em modo nativo.

2. No Explorador de Objetos , selecione Segurança.

3. Selecione Funções.

Solução de problemas

Use o sinalizador -t para receber mais informações. Por exemplo, se executares o script e vires uma mensagem semelhante à seguinte

• Não consegui ligar-me ao servidor: https://\<servername>/ReportServer/ReportService2010.asmx

Execute novamente o script com a bandeira -t , para ver uma mensagem semelhante a esta:

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

Conteúdo relacionado

UtilitárioRS.exe (SSRS)
Compare funções e tarefas nos Serviços de Relatórios com grupos SharePoint e permissões