Utilitário RS.exe (SSRS)

  • Artigo

O utilitário rs.exe processa o script que você fornece em um arquivo de entrada. Use esse utilitário para automatizar a implantação de servidor de relatório e tarefas de administração.

Observação

A partir do SQL Server 2008 R2 (10.50.x), há suporte para o utilitário rs nos servidores de relatório configurados para o modo integrado do SharePoint e nos servidores configurados no modo nativo. As versões anteriores suportavam apenas configurações em modo nativo.

Sintaxe

  
rs {-?}  
{-i input_file}  
{-s serverURL}  
{-u username}  
{-p password}  
{-e endpoint}  
{-l time_out}  
{-b batchmode}  
{-v globalvars=}  
{-t trace}

Local do arquivo

RS.exe está localizado nas seguintes pastas, dependendo da versão do servidor de relatório: Você pode executar o utilitário de qualquer pasta em seu sistema de arquivos.

Aplica-se a: SQL Server Reporting Services (2016)

C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn

Aplica-se a: SQL Server Reporting Services (2017 e posterior)

C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools

Aplica-se a: Servidor de Relatórios do Power BI

C:\Program Files\Microsoft Power BI Report Server\Shared Tools

Argumentos

-?
(Opcional) Exibe a sintaxe de argumentos rs .

-i input_file
(Obrigatório) Especifica o arquivo .rss a ser executado. Esse valor pode ser um parente ou caminho totalmente qualificado para o arquivo .rss.

-s serverURL
(Obrigatório) Especifica o nome do servidor Web e nome do diretório virtual do servidor de relatório no qual executar o arquivo. Um exemplo de uma URL de servidor de relatório é https://examplewebserver/reportserver. O prefixo http:// ou https:// no início do nome do servidor é opcional. Se você omitir o prefixo, o host de script do servidor de relatório tentará usar https primeiro e depois usará http se https não funcionar.

-u [domínio\]nomedeusuário
(Opcional) Especifica uma conta do usuário usada para conexão com o servidor de relatório. Se -u e -p forem omitidos, a conta do usuário do Windows atual será usada.

-p password
(Obrigatório se -u for especificado). Especifica a senha para usar com o argumento -u . Esse valor diferencia maiúsculas de minúsculas.

-e
(Opcional) Especifica o ponto de extremidade SOAP no qual o script deve ser executado. Os valores válidos são:

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Se não for especificado um valor, o ponto de extremidade Mgmt2005 será usado. Para obter mais informações sobre pontos de extremidade de SOAP, consulte Pontos de extremidade do serviço Web do servidor de relatórios.

-l time_out
(Opcional) Especifica o número de segundos antes que a conexão com o servidor expire. O padrão é 60 segundos. Se você não especificar um valor de tempo limite, o padrão será usado. Um valor de 0 especifica que a conexão nunca expira.

-b
(Opcional) Especifica que os comandos no arquivo de script são executados em um lote. Se algum comando falhar, o lote será revertido. Alguns comandos não podem ser processados em lote e são executados como de costume. Somente exceções emitidas e não controladas no resultado de script resultam em reversão. Se o script controlar uma exceção e retornar normalmente de Main, o lote será confirmado. Se você omitir esse parâmetro, os comandos serão executados sem criar um lote. Para obter mais informações, consulte Métodos de lote.

-v globalvar
(Opcional) Especifica variáveis globais usadas no script. Se o script usa variáveis globais, você deve especificar esse argumento. O valor que você especifica deve ser válido para a variável global definida no arquivo .rss. É necessário especificar uma variável global para cada argumento –v.

O argumento –v é especificado na linha de comando e é usado para definir o valor de uma variável global definida no script no tempo de execução. Por exemplo, se seu script contiver uma variável nomeada parentFolder, você poderá especificar um nome para aquela pasta na linha de comando:

rs.exe -i myScriptFile.rss -s https://myServer/reportserver -v parentFolder="Financial Reports"

Variáveis globais são criadas com os nomes dados e definidos para os valores fornecidos. Por exemplo, -v a="1" -v b="2" resulta em uma variável chamada a com valor de "1" e variável b com valor de "2".

Variáveis globais estão disponíveis para qualquer função no script. Uma barra invertida e aspas (\") são interpretadas como aspas duplas. As aspas só serão necessárias se a cadeia de caracteres contiver um espaço. Os nomes das variáveis devem ser válidos para o Microsoft Visual Basic. Eles devem começar com caracteres alfabéticos ou sublinhados e conter caracteres alfabéticos, dígitos ou sublinhados. Palavras reservadas não podem ser usadas como nomes de variável. Para obter mais informações sobre como usar variáveis globais, confira Coleções internas em expressões (Construtor de Relatórios e SSRS).

-t
(Opcional) Produz mensagens de erro para o log de rastreamento. Esse argumento não exige um valor. Para obter mais informações, consulte Report Server Service Trace Log.

Permissões

Para executar essa ferramenta, você deve ter permissão para se conectar à instância do servidor de relatório no qual o script está sendo executado. Você pode executar scripts para fazer alterações no computador local ou em um computador remoto. Para fazer alterações em um servidor de relatório instalado em um computador remoto, especifique o computador remoto no argumento -s .

Exemplos

O exemplo a seguir ilustra como especificar o arquivo de script que contém o script Visual Basic .NET e os métodos do serviço Web que você quer executar.

rs -i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver

Para obter um exemplo detalhado, consulte Script rs.exe do Reporting Services de exemplo para copiar conteúdo entre servidores de relatório.

Para ver outros exemplos, consulte Executar um arquivo de script do Reporting Services

Comentários

Você pode definir scripts para definir propriedades do sistema, publicar relatórios, e assim sucessivamente. Os scripts que você cria podem incluir qualquer método de API do Reporting Services . Para obter mais informações sobre os métodos e propriedades disponíveis, consulte Serviço Web do servidor de relatórios.

O script deve ser gravado no código Visual Basic .NET e armazenado em Unicode ou arquivo de texto UTF-8 com uma extensão de nome de arquivo .rss. Você não pode depurar scripts com o utilitário rs . Para depurar um script, execute o código no Microsoft Visual Studio.

Dica

Para obter um exemplo detalhado, consulte Script rs.exe do Reporting Services de exemplo para copiar conteúdo entre servidores de relatório.

Conteúdo relacionado