utilitário RS.exe (SSRS)

A utilidade rs.exe processa o script que fornece num ficheiro de entrada. Use esta utilidade para automatizar a implementação e administração de servidores de relatórios.

Sintaxe

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

Localização do ficheiro

RS.exe encontra-se nas pastas seguintes, dependendo da versão do servidor de relatórios. Podes executar a ferramenta a partir de qualquer pasta no teu sistema de ficheiros.

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 (versões de 2017 e posteriores)

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

Aplica-se a: Power BI Report Server

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

Arguments

-?
(Opcional) Mostra a sintaxe dos argumentos do rs .

-iinput_file
(Obrigatório) Especifica o ficheiro .rss a executar. Este valor pode ser um caminho relativo ou totalmente qualificado para o ficheiro .rss.

-sserverURL
(Obrigatório) Especifica o nome do servidor Web e o nome do diretório virtual do servidor de relatórios para executar o ficheiro. Um exemplo de URL de servidor de relatórios é https://examplewebserver/reportserver. O prefixo http:// ou https:// no início do nome do servidor é opcional. Se omitires o prefixo, o host do script do servidor de relatórios tenta usar https primeiro, e depois usa http se o https não funcionar.

-u [domínio\]nome de utilizador
(Opcional) Especifica uma conta de utilizador usada para se ligar ao servidor de relatórios. Se -u e -p forem omitidos, a conta de utilizador atual do Windows é utilizada.

-Ppalavra-passe
(Obrigatório se - u for especificado) Especifica a palavra-passe a usar com o argumento -u . Este valor é sensível a maiúsculas e minúsculas.

-e
(Opcional) Especifica o endpoint SOAP contra o qual o script deve ser executado. Os valores válidos são:

• Mgmt2010

• Mgmt2006

• Mgmt2005

• Exec2005

Se um valor não for especificado, é usado o endpoint Mgmt2005. Para mais informações acerca de os endpoints SOAP, consulte endereços de serviço Web do servidor de relatórios.

-ltime_out
(Opcional) Especifica o número de segundos que passam antes de a ligação ao servidor expirar. O padrão é 60 segundos. Se não especificar um valor de time-out, é usado o padrão. Um valor 0 especifica que a ligação nunca expira.

-b
(Opcional) Especifica que os comandos no ficheiro de script são executados em batch. Se algum comando falhar, o lote é revertido. Alguns comandos não podem ser agrupados, e esses comandos correm normalmente. Apenas exceções que são lançadas e não tratadas no script resultam numa reversão. Se o script manipular uma exceção e regressar normalmente do Main, o batch é confirmado. Se omitir este parâmetro, os comandos executam-se sem criar um lote. Para mais informações, veja Métodos de Batching.

-vglobalvar
(Opcional) Especifica variáveis globais que são usadas no script. Se o script usar variáveis globais, deve especificar este argumento. O valor que especifica deve ser válido para a variável global definida no ficheiro .rss. Deve especificar uma variável global para cada argumento -v .

O argumento -v é especificado na linha de comandos e é usado para definir o valor de uma variável global definida no seu script em tempo de execução. Por exemplo, se o seu script contiver uma variável chamada parentFolder, pode especificar um nome para essa pasta na linha de comandos:

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

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

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

-t
(Opcional) Envia mensagens de erro para o registo de rastreios. Este argumento não tem valor. Para mais informações, consulte o registo de rastreamento do serviço do servidor de relatórios.

Permissions

Para executar a ferramenta, tens de ter permissão para te ligares à instância do servidor de relatórios contra a qual estás a executar o script. Podes executar scripts para fazer alterações ao computador local ou a um computador remoto. Para fazer alterações a um servidor de relatórios instalado num computador remoto, especifique o computador remoto no argumento -s .

Examples

O exemplo seguinte ilustra como especificar o ficheiro de script que contém o script Visual Basic .NET e os métodos de serviço Web que pretende executar.

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

Para um exemplo detalhado, veja Sample Reporting Services rs.exe script para copiar conteúdos entre servidores de relatórios.

Para mais exemplos, veja Executar um ficheiro de script dos Serviços de Relatórios

Observações

Podes definir scripts para definir propriedades do sistema, publicar relatórios, e assim por diante. Os scripts que cria podem incluir qualquer método da API de Serviços de Relatórios. Para mais informações sobre os métodos e propriedades disponíveis para si, consulte o serviço web do servidor de Relatórios.

O script deve ser escrito em código do Visual Basic .NET e armazenado num ficheiro de texto Unicode ou UTF-8 com uma extensão de nome de ficheiro .rss. Não podes depurar scripts com a utilidade RS . Para depurar um script, execute o código dentro do Microsoft Visual Studio.

Conteúdo relacionado

• Executar um ficheiro de script dos Serviços de Relatórios
• Implementação de scripts e tarefas administrativas
• Script com o utilitário rs.exe e o serviço Web
• Utilitários da linha de comandos do servidor de relatórios (SSRS)