narzędzie RS.exe (SSRS)

Narzędzie rs.exe przetwarza skrypt, który należy podać w pliku wejściowym. To narzędzie służy do automatyzowania zadań wdrażania i administrowania serwerem raportów.

Składnia

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

Lokalizacja pliku

RS.exe znajduje się w następujących folderach, w zależności od wersji serwera raportów. Narzędzie można uruchomić z dowolnego folderu w systemie plików.

Dotyczy do: SQL Server Reporting Services (2016)

C:\Program Files (x86)\Microsoft SQL Server\130\Tools\Binn  

Dotyczy: SQL Server Reporting Services (2017 i nowsze wersje)

C:\Program Files\Microsoft SQL Server Reporting Services\Shared Tools

Dotyczy: Serwer raportów usługi Power BI

C:\Program Files\Microsoft Power BI Report Server\Shared Tools

Arguments

-?
(Opcjonalnie) Wyświetla składnię argumentów rs .

-iinput_file
(Wymagane) Określa plik .rss do wykonania. Ta wartość może być względną lub w pełni kwalifikowaną ścieżką do pliku .rss.

-sserverURL
(Wymagane) Określa nazwę serwera sieci Web i nazwę katalogu wirtualnego serwera raportów, przeciwko któremu plik zostanie wykonany. Przykładem adresu URL serwera raportów jest https://examplewebserver/reportserver. Prefiks http:// lub https:// na początku nazwy serwera jest opcjonalny. Jeśli pominięto prefiks, host skryptu serwera raportów spróbuje najpierw użyć protokołu https, a następnie użyje protokołu HTTP, jeśli protokół HTTPS nie działa.

-u [domena\]nazwa użytkownika
(Opcjonalnie) Określa konto użytkownika używane do nawiązywania połączenia z serwerem raportów. Jeśli -u i -p są pominięte, używane jest bieżące konto użytkownika systemu Windows.

-phasło
(Wymagane, jeśli określono -u ) Określa hasło, które ma być używane z argumentem -u . Ta wartość jest wrażliwa na wielkość liter.

-e
(Opcjonalnie) Określa punkt końcowy protokołu SOAP, względem którego powinien zostać uruchomiony skrypt. Prawidłowe wartości to:

• Mgmt2010

• Mgmt2006

• Mgmt2005

• Exec2005

Jeśli wartość nie zostanie określona, zostanie użyty punkt końcowy Mgmt2005. Aby uzyskać więcej informacji na temat punktów końcowych protokołu SOAP, zobacz Punkty końcowe usługi sieci Web serwera raportów.

-ltime_out
(Opcjonalnie) Określa liczbę sekund, które upłynęły przed upływem limitu czasu połączenia z serwerem. Wartość domyślna to 60 sekund. Jeśli nie określisz wartości limitu czasu, zostanie użyta wartość domyślna. Wartość 0 określa, że połączenie nigdy nie wygasa.

-b
(Opcjonalnie) Określa, że polecenia w pliku skryptu są uruchamiane w partii. Jeśli jakiekolwiek polecenia nie powiodą się, transakcja zostanie wycofana. Niektórych poleceń nie można przetwarzać wsadowo i są one wykonywane jak zwykle. Tylko wyjątki, które są zgłaszane i nie są obsługiwane w ramach skryptu, powodują wycofanie transakcji. Jeśli skrypt obsługuje wyjątek i poprawnie zwraca z Main, transakcja zostaje zatwierdzona. Jeśli pominięto ten parametr, polecenia są uruchamiane bez tworzenia partii. Aby uzyskać więcej informacji, zobacz Metody batchowania.

-vglobalvar
(Opcjonalnie) Określa zmienne globalne, które są używane w skrygcie. Jeśli skrypt używa zmiennych globalnych, należy określić ten argument. Określona wartość musi być prawidłowa dla zmiennej globalnej zdefiniowanej w pliku .rss. Należy określić jedną zmienną globalną dla każdego argumentu -v .

Argument -v jest określony w wierszu polecenia i służy do ustawiania wartości zmiennej globalnej, która jest zdefiniowana w skry skryptzie w czasie wykonywania. Jeśli na przykład skrypt zawiera zmienną o nazwie parentFolder, możesz określić nazwę tego folderu w wierszu polecenia:

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

Zmienne globalne są tworzone przy użyciu podanych nazw i ustawiane na podane wartości. Na przykład -v a="1" -v b="2" powoduje wyświetlenie zmiennej o nazwie a o wartości "1" i zmiennej b z wartością "2".

Zmienne globalne są dostępne dla każdej funkcji w skrypcie. Znak ukośnika odwrotnego oraz cudzysłów (\") są zinterpretowane jako podwójny cudzysłów. Znaki cudzysłowu są wymagane tylko wtedy, gdy ciąg zawiera spację. Nazwy zmiennych muszą być prawidłowe dla języka Microsoft Visual Basic. Muszą zaczynać się od znaku alfabetu lub znaku podkreślenia i zawierać litery, cyfry lub znaki podkreślenia. Nie można używać wyrazów zarezerwowanych jako nazw zmiennych. Aby uzyskać więcej informacji na temat używania zmiennych globalnych, zobacz Wbudowane kolekcje w wyrażeniach (Report Builder i SSRS).

-t
(Opcjonalnie) Generuje komunikaty o błędach w dzienniku śledzenia. Ten argument nie przyjmuje wartości. Aby uzyskać więcej informacji, zobacz Dziennik śledzenia usługi serwera raportów.

Permissions

Aby uruchomić narzędzie, musisz mieć uprawnienia do nawiązania połączenia z wystąpieniem serwera raportów, względem którego jest uruchamiany skrypt. Skrypty można uruchamiać, aby wprowadzić zmiany na komputerze lokalnym lub komputerze zdalnym. Aby wprowadzić zmiany na serwerze raportów zainstalowanym na komputerze zdalnym, określ komputer zdalny w argumencie -s .

Przykłady

W poniższym przykładzie pokazano, jak określić plik skryptu zawierający skrypt .NET języka Visual Basic i metody usługi sieci Web, które chcesz wykonać.

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

Aby uzyskać szczegółowy przykład, zobacz Przykładowy skrypt usług Reporting Services rs.exe do kopiowania zawartości między serwerami raportów.

Aby uzyskać więcej przykładów, zobacz Uruchom plik skryptu usług Reporting Services

Uwagi

Skrypty można zdefiniować, aby ustawić właściwości systemu, publikować raporty itd. Utworzone skrypty mogą zawierać dowolne metody interfejsu API usług Reporting Services. Aby uzyskać więcej informacji na temat dostępnych metod i właściwości, zobacz Usługa sieci Web serwera raportów.

Skrypt musi być napisany w kodzie .NET języka Visual Basic i przechowywany w pliku tekstowym Unicode lub UTF-8 z rozszerzeniem nazwy pliku .rss. Nie można debugować skryptów za pomocą narzędzia rs . Aby debugować skrypt, uruchom kod w programie Microsoft Visual Studio.

Treści powiązane

• Uruchamianie pliku skryptu usług Reporting Services
• Wdrażanie skryptów i zadania administracyjne
• Skrypt za pomocą narzędzia rs.exe i usługi internetowej
• Narzędzia wiersza polecenia serwera raportów (SSRS)