Share via

Utilità rs

  • Articolo

Elabora gli script forniti in un file di input. Utilizzare questa utilità per automatizzare le attività di amministrazione e distribuzione dei server di report.

ms162839.note(it-it,SQL.90).gifImportante:
L'utilità rs non è supportata con server di report configurati per la modalità di integrazione con SharePoint.

Sintassi


rs {-?}
[-iinput_file=]
[-sserverURL]
{-uusername}
{-ppassword}
{-ltime_out}
{-bbatchmode}
{-vglobalvars=}
{-eendpoint}
{-ttrace}

Argomenti

  • -?
    (Facoltativo) Visualizza la sintassi degli argomenti di rs.
  • -iinput_file
    (Obbligatorio) Specifica il file con estensione rss da eseguire. Come valore è possibile indicare il percorso relativo o completo di tale file.
  • -sserverURL
    (Obbligatorio) Specifica 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 tenterà con https e, qualora non funzionasse, poi utilizzerà http.
  • -u [domain\]username
    (Facoltativo) Specifica l'account utente utilizzato per connettersi al server di report. Se si omettono -u e -p, verrà utilizzato l'account utente di Windows corrente.
  • -ppassword
    (Obbligatorio se si specifica -u) Specifica la password da utilizzare con l'argomento -u. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.
  • -ltime_out
    (Facoltativo) Specifica 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 Batching Methods.

  • -vglobalvar
    (Facoltativo) Specifica 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 rss. È necessario specificare una variabile globale per ogni argomento –v.

    L'argomento -v viene specificato nella riga di comando e viene utilizzato per impostare il valore di una variabile globale definita nello script in fase di esecuzione. Ad esempio, se lo script contiene un variabile denominata parentFolder, è possibile specificare un nome per la cartella sulla 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 .NET, 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 Utilizzo di insiemi Global nelle espressioni (Reporting Services).

  • -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 di Reporting Services.

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 di servizio Web che si desidera eseguire.

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

[!NOTA] In Reporting Services sono disponibili numerosi file script di esempio che è possibile utilizzare per apprendere come incorporare i metodi di servizio Web ReportServer nello script di Visual Basic .NET. Per ulteriori informazioni, vedere Script di esempio (Reporting Services).

Posizione del file

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

Osservazioni

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

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 da Microsoft Visual Studio.

Vedere anche

Altre risorse

Running a Reporting Services Script File
Utilizzo di script per l'esecuzione di attività di distribuzione e di amministrazione
Scripting with the rs Utility and the Web Service
Utilità della riga di comando del server di report

Guida in linea e informazioni

Assistenza su SQL Server 2005