RS.exe Utility (SSRS)

Artigo
06/13/2017

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, o utilitário rs tem suporte em servidores de relatório configurados para o modo integrado do SharePoint, bem como em servidores configurados no modo nativo. As versões anteriores suportavam apenas configurações em modo nativo.

Neste tópico:

Local do arquivo
Argumentos
Permissões
Exemplos

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 em \Arquivos de Programas\Microsoft SQL Server\110\Tools\Binn. Você pode executar o utilitário de qualquer pasta em seu sistema de arquivos.

Argumentos

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

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

-sserverURL
(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 é http://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\]nome de usuá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.

-psenha
(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 os seguintes:

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 Report Server Web Service Endpoints.

-ltime_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 Batching Methods.

-vGlobalVar
(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 seu script em 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 http://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 nomeada a com um valor de"1" e uma variável b com um 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 de variáveis devem ser válidos para o Microsoft Visual Basic; eles devem começar com um caractere alfabético ou sublinhado 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 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Para ver exemplos adicionais, 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 Report Server Web Service.

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 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Confira também

Executar um arquivo de script do Reporting Services
Implantação de script e tarefas administrativas
Gerar scripts com o utilitário rs.exe e o serviço Web
Utilitários de prompt de comando do servidor de relatório (SSRS)

Compartilhar via