Utilità rs (rs.exe) (SSRS)

Articolo
04/02/2014

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, l'utilità rs è supportata sia nei server di report configurati per la modalità integrata SharePoint sia 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 file

RS.exe si trova in \Programmi\Microsoft SQL Server\110\Tools\Binn. È possibile eseguire l'utilità da qualsiasi cartella del file system.

Argomenti

-?
(Facoltativo) Consente di visualizzare la sintassi degli argomenti di 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 è http://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à utilizzato l'account utente di Windows corrente.
-p password
(Obbligatorio se si specifica -u) Consente di specificare la password da utilizzare 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. Di seguito sono riportati i valori validi:
- Mgmt2010
- Mgmt2006
- Mgmt2005
- Exec2005
Se non si specifica alcun valore, viene utilizzato l'endpoint Mgmt2005. Si noti che il valore Mgmt2000 è obsoleto e non è più un valore valido in questa versione. Per ulteriori informazioni sugli endpoint SOAP e sulle caratteristiche deprecate, vedere Endpoint del servizio Web ReportServer e Funzionalità deprecate di SQL Server Reporting Services in SQL Server 2012
-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 ulteriori informazioni, vedere Metodi di invio in batch.
-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 ed è utilizzato per 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 http://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, pertanto 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 ulteriori informazioni sull'utilizzo delle variabili globali, vedere Raccolte predefinite nelle espressioni (Generatore report e SSRS).
-t
(Facoltativo) Crea l'output dei messaggi di errore nel log di traccia. Questo argomento non accetta un valore. Per ulteriori informazioni, vedere Log di traccia del servizio del 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 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Per ulteriori esempi, vedere Eseguire un file 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 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.