Utilità RS.exe (SSRS)

  • Articolo

L'utilità rs.exe elabora lo script fornito in un file di input. Utilizzare questa utilità per automatizzare le attività di amministrazione e distribuzione dei server di report.

Nota

A partire da SQL Server 2008 R2 (10.50.x), l'utilità rs è supportata sia nei server di report configurati per la modalità integrata SharePoint che in quelli configurati in modalità nativa. Le versioni precedenti supportano solo le configurazioni in modalità nativa.

Sintassi

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

Percorso del file

Il file RS.exe si trova nelle cartelle seguenti, a seconda della versione del server di report: È possibile eseguire l'utilità da qualsiasi cartella del file system.

Si applica a: SQL Server Reporting Services (2016)

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

Si applica a: SQL Server Reporting Services (2017 versioni successive)

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

Si applica a: Server di report di Power BI

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

Argomenti

-?
(Facoltativo) Visualizza la sintassi degli argomenti rs .

-i input_file
(Obbligatorio) Consente di specificare il file con estensione rss da eseguire. Come valore è possibile indicare il percorso relativo o completo di tale file.

-s serverURL
(Obbligatorio) Consente di specificare il nome del server Web e il nome della directory virtuale del server di report in cui eseguire il file. Un esempio di URL del server di report è https://examplewebserver/reportserver. Il prefisso http:// o https:// all'inizio del nome del server è facoltativo. Se si omette il prefisso, lo script del server di report prima tenta di utilizzare https e, qualora non funzionasse, utilizza http.

-u [domain\]username
(Facoltativo) Consente di specificare l'account utente utilizzato per connettersi al server di report. Se si omettono -u e -p , verrà usato l'account utente di Windows corrente.

-p password
(Obbligatorio se si specifica -u ) Consente di specificare la password da usare con l'argomento -u . Per questo valore viene applicata la distinzione tra maiuscole e minuscole.

-e
(Facoltativo) Specifica l'endpoint SOAP in base al quale eseguire lo script. I valori validi sono:

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Se non si specifica alcun valore, viene utilizzato l'endpoint Mgmt2005. Per ulteriori informazioni sugli endpoint SOAP, vedere Endpoint servizio Web ReportServer.

-l time_out
(Facoltativo) Consente di specificare quanti secondi devono trascorrere prima del timeout della connessione al server. Il valore predefinito è 60 secondi. Se non si specifica un valore per il timeout, verrà utilizzato il valore predefinito. Se si specifica il valore 0 , non si verificherà mai il timeout della connessione.

-b
(Facoltativo) Specifica che i comandi del file di script vengano eseguiti come batch. Se uno o più comandi hanno esito negativo, verrà eseguito il rollback dell'intero batch. Vi sono tuttavia comandi non eseguibili in batch. Tali comandi verranno eseguiti normalmente e verrà eseguito un rollback solo in caso di eccezioni generate e non gestite nell'ambito dello script. Se lo script gestisce un'eccezione e completa normalmente la routine Main, verrà eseguito il commit del batch. Se si omette questo parametro, i comandi verranno eseguiti senza la creazione di un batch. Per altre informazioni, vedere Batching Methods.

-v globalvar
(Facoltativo) Consente di specificare le variabili globali utilizzate nello script. Se lo script utilizza variabili globali, è necessario specificare questo argomento. Il valore specificato deve essere valido per la variabile globale definita nel file con estensione rss. È necessario specificare una variabile globale per ogni argomento -v.

L'argomento -v viene specificato nella riga di comando e consente di impostare il valore per una variabile globale definita in fase di esecuzione nello script. Se, ad esempio, lo script contiene un variabile denominata parentFolder, è possibile specificare un nome per la cartella nella riga di comando:

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

Le variabili globali vengono create con i nomi indicati e impostate sui valori specificati. Ad esempio, -v a="1" -v b="2" restituisce una variabile denominata a con un valore di "1" e una variabile b con un valore di "2".

Le variabili globali sono disponibili per qualsiasi funzione nello script. Una barra rovesciata seguita dalle virgolette (\") viene interpretata come virgolette doppie. Le virgolette sono necessarie solo se la stringa contiene uno spazio. I nomi delle variabili devono essere validi per Microsoft Visual Basic. Devono iniziare con un carattere alfabetico o un carattere di sottolineatura e contenere caratteri alfabetici, numerici o di sottolineatura. Le parole riservate non possono essere utilizzate come nomi di variabili. Per altre informazioni sull'uso delle variabili globali, vedere Raccolte predefinite nelle espressioni (Generatore di report e SSRS).

-t
(Facoltativo) Crea l'output dei messaggi di errore nel log di traccia. Questo argomento non accetta un valore. Per altre informazioni, vedere Log di analisi servizio server di report.

Autorizzazioni

Per eseguire questo strumento, è necessario disporre dell'autorizzazione per connettersi all'istanza del server di report in cui lo script è in esecuzione. È possibile eseguire script per apportare modifiche nel computer locale o in un computer remoto. Per apportare modifiche a un server di report installato in un computer remoto, specificare il computer remoto nell'argomento -s .

Esempi

Nell'esempio seguente viene illustrato come specificare il file script contenente lo script di Visual Basic .NET e i metodi del servizio Web che si desidera eseguire.

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

Per un esempio dettagliato, vedere Script di esempio rs.exe di Reporting Services per la copia di contenuto tra server di report.

Per ulteriori esempi, vedere Eseguire un file di script di Reporting Services

Osservazioni:

È possibile definire script per impostare le proprietà di sistema, pubblicare report e così via. Gli script creati possono includere qualsiasi metodo dell'API di Reporting Services. Per ulteriori informazioni sui metodi e sulle proprietà disponibili, vedere servizio Web ReportServer.

Lo script deve essere scritto in codice Visual Basic .NET e archiviato in un file di testo Unicode o UTF-8 con estensione di file rss. Non è possibile eseguire il debug degli script con l'utilità rs. Per eseguire il debug di uno script, eseguire il codice in Microsoft Visual Studio.

Suggerimento

Per un esempio dettagliato, vedere Script di esempio rs.exe di Reporting Services per la copia di contenuto tra server di report.

Contenuto correlato