Utilità rs

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 tenta di utilizzare https e, qualora non funzionasse, utilizza 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 Metodi di invio in batch.

• -e
  (Facoltativo) Specifica l'endpoint SOAP in base al quale eseguire lo script. I valori validi includono Exec2005 e Mgmt2005. 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. Poiché inoltre rs.exe non supporta la modalità integrata SharePoint, l'elenco di valori validi non include l'endpoint ReportService2006. Per ulteriori informazioni sugli endpoint SOAP e le funzionalità obsolete, vedere Endpoint del servizio Web ReportServer e Funzionalità obsolete di SQL Server Reporting Services.

• -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 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 MicrosoftVisual 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 Utilizzo di raccolte predefinite 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 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

Posizione del file

Rs.exe si trova in \Programmi\Microsoft SQL Server\100\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 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 MicrosoftVisual Studio.

Vedere anche

Concetti

Altre risorse