Hilfsprogramm 'RS.exe' (SSRS)

  • Artikel

Das Dienstprogramm rs.exe verarbeitet Skripts, die von Ihnen in einer Eingabedatei bereitgestellt werden. Verwenden Sie dieses Hilfsprogramm, um die Berichtsserverbereitstellung und Verwaltungsaufgaben zu automatisieren.

Hinweis

Ab SQL Server 2008 R2 wird das Hilfsprogramm rs für Berichtsserver unterstützt, die für den integrierten SharePoint-Modus konfiguriert sind, sowie server, die im nativen Modus konfiguriert sind. In früheren Versionen wurden nur Konfigurationen im einheitlichen Modus unterstützt.

In diesem Thema:

Syntax

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

Dateispeicherort

RS.exe befindet sich unter \Programme\Microsoft SQL Server\110\Tools\Binn. Sie können das Hilfsprogramm von einem beliebigen Ordner im Dateisystem ausführen.

Argumente

-?
(Optional) Zeigt die Syntax der rs -Argumente an.

-iinput_file
(Erforderlich) Gibt die auszuführende RSS-Datei an. Dieser Wert kann einen relativen oder einen vollqualifizierten Pfad zur RSS-Datei enthalten.

-sserverURL
(Erforderlich) Gibt den Namen des Webservers und den Namen des virtuellen Verzeichnisses auf dem Berichtsserver an, in dem die Datei ausgeführt werden soll. Ein Beispiel für eine Berichtsserver-URL ist http://examplewebserver/reportserver. Das Präfix http:// oder https:// zu Beginn des Servernamens ist optional. Wenn Sie kein Präfix angeben, verwendet der Berichtsserver-Skripthost zunächst https:// und dann http://, falls https:// nicht verfügbar ist.

-u [Domäne\]Benutzername
(Optional) Gibt ein Benutzerkonto an, das für die Herstellung einer Verbindung mit dem Berichtsserver verwendet wird. Wenn -u und -p nicht angegeben werden, wird das aktuelle Windows-Benutzerkonto verwendet.

-pPasswort
(Erforderlich, wenn -u angegeben ist.) Gibt das Kennwort an, das mit dem -u-Argument verwendet wird. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.

-e
(Optional) Gibt den SOAP-Endpunkt für die Ausführung des Skripts an. Folgende Werte sind gültig:

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

Wird kein Wert angegeben, wird der Endpunkt Mgmt2005 verwendet. Weitere Informationen zu den SOAP-Endpunkten finden Sie unter Report Server Web Service Endpoints.

-ltime_out
(Optional) Gibt die Anzahl von Sekunden an, die verstreichen, ehe sich für die Verbindung mit dem Server ein Timeout ergibt. Der Standardwert ist 60 Sekunden. Wenn Sie keinen Timeoutwert angeben, wird der Standardwert verwendet. Ein Wert von 0 gibt an, dass sich für die Verbindung kein Timeout ergibt.

-b
(Optional) Gibt an, dass die Befehle in der Skriptdatei als Batch ausgeführt werden. Falls ein Befehl fehlschlägt, wird ein Rollback für den Batch ausgeführt. Einige Befehle können nicht als Batch ausgeführt werden. Diese Befehle werden wie gewohnt ausgeführt. Nur Ausnahmen, die ausgegeben werden und nicht innerhalb des Skripts behandelt werden, führen zu einem Rollback. Wenn das Skript eine Ausnahme behandelt und normalerweise von Main zurückgegeben wird, wird ein Commit für den Batch ausgeführt. Wenn Sie diesen Parameter nicht angeben, werden die Befehle ausgeführt, ohne dass ein Batch erstellt wird. Weitere Informationen finden Sie unter Batching Methods.

-vglobalvar
(Optional) Gibt globale Variablen an, die in dem Skript verwendet werden. Wenn das Skript globale Variablen verwendet, müssen Sie dieses Argument angeben. Der angegebene Wert muss für die in der RSS-Datei definierten globalen Variablen gültig sein. Sie müssen eine globale Variable für jedes -v-Argument angeben.

Das Argument -v wird in der Befehlszeile angegeben und verwendet, um zur Laufzeit einen Wert für eine globale Variable festzulegen, die in Ihrem Skript definiert ist. Wenn Ihr Skript beispielsweise eine Variable namens parentFolder, enthält, können Sie in der Befehlszeile einen Namen für diesen Ordner angeben:

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

Globale Variablen werden mit den vorliegenden Namen erstellt und auf die bereitgestellten Werte festgelegt. Beispielsweise führt -v a="1" -v b="2" zu einer Variablen mit a dem Wert ""1 und einer Variablen b mit dem Wert "2".

Globale Variablen stehen für alle Funktionen im Skript zur Verfügung. Eine Kombination von umgekehrtem Schrägstrich und einem Anführungszeichen (\") wird als Anführungszeichen interpretiert. Anführungszeichen sind nur erforderlich, wenn die Zeichenfolge ein Leerzeichen enthält. Namen von Variablen müssen für Microsoft Visual Basic gültig sein: sie müssen mit einem Buchstaben oder Unterstrich beginnen und Buchstaben, Zahlen oder Unterstriche enthalten. Reservierte Wörter können nicht als Variablennamen verwendet werden. Weitere Informationen zur Verwendung globaler Variablen finden Sie unter Integrierte Sammlungen in Ausdrücken (Berichts-Generator und SSRS).

-t
(Optional) Schreibt Fehlermeldungen in das Ablaufverfolgungsprotokoll. Dieses Argument enthält keinen Wert. Weitere Informationen finden Sie unter Report Server Service Trace Log.

Berechtigungen

Um das Tool ausführen zu können, müssen Sie die Berechtigung besitzen, eine Verbindung mit der Berichtsserverinstanz herzustellen, für die das Skript ausgeführt wird. Durch das Ausführen von Skripts können Sie Änderungen am lokalen Computer oder an einem Remotecomputer durchführen. Sollen Änderungen an einem Berichtsserver durchgeführt werden, der auf einem Remotecomputer installiert ist, geben Sie den Remotecomputer im -s-Argument an.

Beispiele

Das folgende Beispiel zeigt, wie die Skriptdatei angegeben wird, die das Visual Basic .NET-Skript und die auszuführenden Webdienstmethoden enthält.

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

Ein ausführliches Beispiel finden Sie unter Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Weitere Beispiele finden Sie unter Ausführen einer Reporting Services-Skriptdatei

Bemerkungen

Sie können Skripts so definieren, dass sie Systemeigenschaften festlegen, Berichte veröffentlichen usw. Die Skripts, die Sie erstellen, können jede Methode der Reporting Services -API einschließen. Weitere Informationen zu den verfügbaren Methoden und Eigenschaften finden Sie unter Report Server Web Service.

Das Skript muss in Visual Basic .NET-Code geschrieben und in einer Unicode- oder UTF-8-Textdatei mit der Dateinamenerweiterung „.rss“ gespeichert sein. Das Hilfsprogramm rs kann nicht zum Debuggen von Skripts verwendet werden. Führen Sie den Code in Microsoft Visual Studio aus, um ein Skript zu debuggen.

Tipp

Ein ausführliches Beispiel finden Sie unter Sample Reporting Services rs.exe Script to Migrate Content between Report Servers.

Weitere Informationen

Run a Reporting Services Script File (Ausführen einer Reporting Services-Skriptdatei)
Script Deployment and Administrative Tasks (Skripts für Bereitstellungs- und Verwaltungsaufgaben)
Script with the rs.exe Utility and the Web Service (Skripterstellung mit dem Hilfsprogramm rs.exe und dem Webdienst)
Eingabeaufforderungs-Hilfsprogramme für Berichtsserver (SSRS)