rs (Dienstprogramm)

  • Artikel

Verarbeitet von Ihnen in einer Eingabedatei bereitgestellte Skripts. Verwenden Sie dieses Dienstprogramm, um die Berichtsserverbereitstellung und Verwaltungsaufgaben zu automatisieren.

ms162839.note(de-de,SQL.90).gifWichtig:
Das rs-Dienstprogramm wird nicht für Berichtsserver unterstützt, die für den integrierten Modus von SharePoint konfiguriert sind.

Syntax


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

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 einen 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 [domain\]username
    (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.
  • -ppassword
    (Erforderlich, wenn -u angegeben ist.) Gibt das Kennwort an, das mit dem -u-Argument verwendet wird. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet.
  • -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 -v-Argument wird in der Befehlszeile angegeben und zum Festlegen des Werts für eine globale Variable verwendet, die zur Laufzeit in Ihrem Skript definiert wird. Wenn Ihr Skript beispielsweise eine Variable mit dem Namen parentFolder enthält, können Sie einen Namen für den Ordner in der Befehlszeile eingeben:

    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. Durch Angeben von -v a="1" -v b="2" werden z. B. eine Variable namens a mit einem Wert von "1" und eine Variable namens b mit einem Wert von "2" erstellt.

    Globale Variablen stehen für alle Funktionen im Skript zur Verfügung. Eine Kombination von umgekehrtem Schrägstrich und 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 dürfen ausschließlich Buchstaben, Ziffern oder Unterstriche enthalten. Reservierte Wörter können nicht als Variablennamen verwendet werden. Weitere Informationen zu globalen Variablen finden Sie unter Verwenden globaler Auflistungen in Ausdrücken (Reporting Services).

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 Webdienstmethoden, die ausgeführt werden sollen, enthält.

rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
ms162839.note(de-de,SQL.90).gifHinweis:
Reporting Services enthält mehrere Beispielskriptdateien, die veranschaulichen, wie Berichtsserver-Webdienstmethoden in Visual Basic .NET-Skripts integriert werden können. Weitere Informationen finden Sie unter Skriptbeispiele (Reporting Services).

Dateispeicherort

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

Hinweise

Sie können Skripts so definieren, dass sie Systemeigenschaften festlegen, Berichte veröffentlichen usw. Die von Ihnen erstellten Skripts können beliebige Methoden der Reporting Services-API (Application Programming Interface, Schnittstelle für Anwendungsprogrammierung) enthalten. 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 RSS-Dateinamenerweiterung gespeichert sein. Das Dienstprogramm rs kann nicht zum Debuggen von Skripts verwendet werden. Führen Sie zum Debuggen eines Skripts den Code in Microsoft Visual Studio aus.

Siehe auch

Andere Ressourcen

Running a Reporting Services Script File
Verwenden von Skripts für Bereitstellungs- und Verwaltungsaufgaben
Scripting with the rs Utility and the Web Service
Berichtsserver-Befehlszeilenprogramme

Hilfe und Informationen

Informationsquellen für SQL Server 2005