RS.exe Utility (SSRS)RS.exe Utility (SSRS)

L'utilità rs.exe elabora lo script fornito in un file di input.The rs.exe utility processes script that you provide in an input file. Utilizzare questa utilità per automatizzare le attività di amministrazione e distribuzione dei server di report.Use this utility to automate report server deployment and administration tasks.

Nota

A partire da SQL Server 2008 R2SQL Server 2008 R2, l'utilità rs è supportata sia nei server di report configurati per la modalità integrata SharePoint che in quelli configurati in modalità nativa.Beginning with SQL Server 2008 R2SQL Server 2008 R2, the rs utility is supported against report servers that are configured for SharePoint integrated mode as well as servers configured in native mode. Le versioni precedenti supportano solo le configurazioni in modalità nativa.Previous versions only supported native mode configurations.

SintassiSyntax


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

Percorso del file File Location

RS.exe si trova in \Programmi\Microsoft SQL Server\110\Tools\Binn.RS.exe is located at \Program Files\Microsoft SQL Server\110\Tools\Binn. È possibile eseguire l'utilità da qualsiasi cartella del file system.You can run the utility from any folder on your file system.

Argomenti Arguments

-?-?
(Facoltativo) Visualizza la sintassi degli argomenti rs .(Optional) Displays the syntax of rs arguments.

-i input_file-i input_file
(Obbligatorio) Consente di specificare il file con estensione rss da eseguire.(Required) Specifies the .rss file to execute. Come valore è possibile indicare il percorso relativo o completo di tale file.This value can be a relative or fully qualified path to the .rss file.

-s serverURL-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.(Required) Specifies the Web server name and report server virtual directory name to execute the file against. Un esempio di URL del server di report è http://examplewebserver/reportserver.An example of a report server URL is http://examplewebserver/reportserver. Il prefisso http:// o https:// all'inizio del nome del server è facoltativo.The prefix http:// or https:// at the beginning of the server name is optional. Se si omette il prefisso, lo script del server di report prima tenta di utilizzare https e, qualora non funzionasse, utilizza http.If you omit the prefix, the report server script host tries to use https first, and then uses http if https does not work.

-u [dominio\]nomeutente-u [domain\]username
(Facoltativo) Consente di specificare l'account utente utilizzato per connettersi al server di report.(Optional) Specifies a user account used to connect to the report server. Se si omettono -u e -p , verrà usato l'account utente di Windows corrente.If -u and -p are omitted, the current Windows user account is used.

-p password-p password
(Obbligatorio se si specifica -u ) Consente di specificare la password da usare con l'argomento -u .(Required if -u is specified) Specifies the password to use with the -u argument. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.This value is case-sensitive.

-e-e
(Facoltativo) Specifica l'endpoint SOAP in base al quale eseguire lo script.(Optional) Specifies the SOAP endpoint against which the script should run. Di seguito sono riportati i valori validi:Valid values are the following:

  • Mgmt2010Mgmt2010

  • Mgmt2006Mgmt2006

  • Mgmt2005Mgmt2005

  • Exec2005Exec2005

    Se non si specifica alcun valore, viene utilizzato l'endpoint Mgmt2005.If a value is not specified, the Mgmt2005 endpoint is used. Per ulteriori informazioni sugli endpoint SOAP, vedere Report Server Web Service Endpoints.For more information about the SOAP endpoints, see Report Server Web Service Endpoints.

    -l time_out-l time_out
    (Facoltativo) Consente di specificare quanti secondi devono trascorrere prima del timeout della connessione al server.(Optional) Specifies the number of seconds that elapse before the connection to the server times out. Il valore predefinito è 60 secondi.The default is 60 seconds. Se non si specifica un valore per il timeout, verrà utilizzato il valore predefinito.If you do not specify a time-out value, the default is used. Se si specifica il valore 0 , non si verificherà mai il timeout della connessione.A value of 0 specifies that the connection never times out.

    -b-b
    (Facoltativo) Specifica che i comandi del file di script vengano eseguiti come batch.(Optional) Specifies that the commands in the script file run in a batch. Se uno o più comandi hanno esito negativo, verrà eseguito il rollback dell'intero batch.If any commands fail, the batch is rolled back. Vi sono tuttavia comandi non eseguibili in batch. Tali comandi verranno eseguiti normalmenteSome commands cannot be batched, and those run as usual. e verrà eseguito un rollback solo in caso di eccezioni generate e non gestite nell'ambito dello script.Only exceptions that are thrown and are not handled within the script result in a rollback. Se lo script gestisce un'eccezione e completa normalmente la routine Main, verrà eseguito il commit del batch.If the script handles an exception and returns normally from Main, the batch is committed. Se si omette questo parametro, i comandi verranno eseguiti senza la creazione di un batch.If you omit this parameter, the commands run without creating a batch. Per altre informazioni, vedere Batching Methods.For more information, see Batching Methods.

    -v globalvar-v globalvar
    (Facoltativo) Consente di specificare le variabili globali utilizzate nello script.(Optional) Specifies global variables that are used in the script. Se lo script utilizza variabili globali, è necessario specificare questo argomento.If the script uses global variables, you must specify this argument. Il valore specificato deve essere valido per la variabile globale definita nel file con estensione rss.The value that you specify must be valid for global variable defined in the .rss file. È necessario specificare una variabile globale per ogni argomento –v .You must specify one global variable for each –v argument.

    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.The -v argument is specified on the command line and is used to set the value for a global variable that is defined in your script at run time. Se, ad esempio, lo script contiene un variabile denominata parentFolder, è possibile specificare un nome per la cartella nella riga di comando:For example, if your script contains a variable named parentFolder, you can specify a name for that folder on the command line:

    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.Global variables are created with the names given and set to the values supplied. 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".For example, -v a="1" -v b="2" results in a variable named a with a value of"1" and a variable b with a value of "2".

    Le variabili globali sono disponibili per qualsiasi funzione nello script.Global variables are available to any function in the script. Una barra rovesciata seguita dalle virgolette (\") viene interpretata come virgolette doppie.A backslash and quotation mark (\") is interpreted as a double quotation mark. Le virgolette sono necessarie solo se la stringa contiene uno spazio.The quotation marks are required only if the string contains a space. I nomi delle variabili devono essere validi per MicrosoftMicrosoft Visual BasicVisual Basic, pertanto devono iniziare con un carattere alfabetico o un carattere di sottolineatura e contenere caratteri alfabetici, numerici o di sottolineatura.Variable names must be valid for MicrosoftMicrosoft Visual BasicVisual Basic; they must start with alphabetical character or underscore and contain alphabetical characters, digits, or underscores. Le parole riservate non possono essere utilizzate come nomi di variabili.Reserved words cannot be used as variable names. Per altre informazioni sull'uso delle variabili globali, vedere Raccolte predefinite nelle espressioni (Generatore report e SSRS).For more information about using global variables, see Built-in Collections in Expressions (Report Builder and SSRS).

    -t-t
    (Facoltativo) Crea l'output dei messaggi di errore nel log di traccia.(Optional) Outputs error messages to the trace log. Questo argomento non accetta un valore.This argument does not take a value. Per altre informazioni, vedere Report Server Service Trace Log.For more information, see Report Server Service Trace Log.

Permissions Permissions

Per eseguire questo strumento, è necessario disporre dell'autorizzazione per connettersi all'istanza del server di report in cui lo script è in esecuzione.To run the tool, you must have permission to connect to the report server instance you are running the script against. È possibile eseguire script per apportare modifiche nel computer locale o in un computer remoto.You can run scripts to make changes to the local computer or a remote computer. Per apportare modifiche a un server di report installato in un computer remoto, specificare il computer remoto nell'argomento -s .To make changes to a report server installed on a remote computer, specify the remote computer in the -s argument.

Esempi Examples

Nell'esempio seguente viene illustrato come specificare il file script contenente lo script di Visual BasicVisual Basic .NET e i metodi del servizio Web che si desidera eseguire.The following example illustrates how to specify the script file that contains Visual BasicVisual Basic .NET script and Web service methods that you want to execute.

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

Per un esempio dettagliato, vedere Script di esempio rs.exe di Reporting Services per la copia di contenuto tra server di report.For a detailed example, see Sample Reporting Services rs.exe Script to Copy Content between Report Servers.

Per ulteriori esempi, vedere Eseguire un file script di Reporting ServicesFor additional examples, see Run a Reporting Services Script File

OsservazioniRemarks

È possibile definire script per impostare le proprietà di sistema, pubblicare report e così via.You can define scripts to set system properties, publish reports, and so forth. Gli script creati possono includere qualsiasi metodo dell'API di Reporting ServicesReporting Services .The scripts that you create can include any methods of the Reporting ServicesReporting Services API. Per ulteriori informazioni sui metodi e sulle proprietà disponibili, vedere Report Server Web Service.For more information about the methods and properties available to you, see Report Server Web Service.

Lo script deve essere scritto in codice Visual BasicVisual Basic .NET e archiviato in un file di testo Unicode o UTF-8 con estensione di file rss.The script must be written in Visual BasicVisual Basic .NET code, and stored in a Unicode or UTF-8 text file with an .rss file name extension. Non è possibile eseguire il debug degli script con l'utilità rs .You cannot debug scripts with the rs utility. Per eseguire il debug di uno script, eseguire il codice in MicrosoftMicrosoft Visual StudioVisual Studio.To debug a script, run the code within MicrosoftMicrosoft Visual StudioVisual Studio.

Vedere ancheSee Also