Utilitário rs
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.
.gif "Observação") Observação |
|---|
A partir do SQL Server 2008 R2, o utilitário rs tem suporte para servidores de relatório configurados para o modo integrado do SharePoint bem como para 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}
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 é 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 [domain\]username
(Opcional) Especifica uma conta do usuário usada para conexão com o servidor de relatório. Se -u e -pforem 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 os seguintes:Mgmt2010
Mgmt2006
Mgmt2005
Exec2005
Se não for especificado um valor, o ponto de extremidade Mgmt2005 será usado. Observe que o valor Mgmt2000 é descontinuado nesta versão e não é mais um valor válido. Para obter mais informações sobre os pontos de extremidade SOAP e recursos substituídos, consulte Pontos de extremidade do serviço Web do servidor de relatório e Recursos substituídos no SQL Server Reporting Services.
-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 processamento em lote.-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. Você deve 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 chamada 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. Nomes de variáveis devem ser válidas para o Microsoft Visual Basic; eles devem iniciar 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 o uso de variáveis globais, consulte Usando coleções internas em expressões (Construtor de Relatórios 3.0 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 Log de rastreamento do serviço do servidor de relatório.
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 exemplos adicionais, consulte Executando um arquivo de script do Reporting Services
Local do arquivo
RS.exe está localizado em \Arquivos de Programas\Microsoft SQL Server\100\Tools\Binn. Você pode executar o utilitário de qualquer pasta em seu sistema de arquivos.
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 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.