Utilitário rs
Processa script que você fornece em um arquivo de entrada. Use esse utilitário para automatizar a implantação de servidor de relatório e as tarefas de administração.
.gif "Observação importante") Importante |
|---|
O utilitário rs não tem suporte em servidores de relatório configurados para o modo integrado do SharePoint. |
Sintaxe
rs {-?}
[-iinput_file=]
[-sserverURL]
{-uusername}
{-ppassword}
{-ltime_out}
{-bbatchmode}
{-vglobalvars=}
{-eendpoint}
{-ttrace}
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 [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.-psenha
(Obrigatório se -u for especificado). Especifica a senha para usar com o argumento -u. Esse valor diferencia maiúsculas de minúsculas.-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 Métodos de processamento em lote.-e
(Opcional) Especifica o ponto de extremidade de SOAP no qual o script deve ser executado. Os valores válidos incluem Exec2005 ou Mgmt2005. Se um valor não for especificado, o ponto de extremidade de Mgmt2005 será usado. Observe que o valor Mgmt2000 é descontinuado nesta versão e não é mais um valor válido. Além disso, como rs.exe não oferece suporte ao modo integrado do SharePoint, a lista de valores válidos não inclui o ponto de extremidade ReportService2006. Para obter mais informações sobre os pontos de extremidade de SOAP e recursos preteridos, consulte Pontos de extremidade do serviço Web do servidor de relatório e Recursos substituídos no SQL Server Reporting Services.-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 em 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 MicrosoftVisual 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 (Reporting Services).
-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
.gif "Observação") Observação |
|---|
O Reporting Services inclui vários arquivos de script de exemplo que você pode usar para aprender como incorporar métodos do serviço Web Servidor de Relatórios no script Visual Basic .NET. Para obter mais informações, consulte Sample Scripts. |
Local do arquivo
Rs.exe fica 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 MicrosoftVisual Studio.