共用方式為

RS.exe Utility (SSRS)

  • 發行項

rs.exe 公用程式會處理您在輸入檔中所提供的指令碼。 使用此公用程式可自動化報表伺服器部署和管理工作。

注意

從 SQL Server 2008 R2 開始， rs 公用程式支援針對針對 SharePoint 整合模式設定的報表伺服器，以及以原生模式設定的伺服器。 之前舊版只支援原生模式組態。

本主題內容：

語法

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

檔案位置

RS.exe 位在 \Program Files\Microsoft SQL Server\110\Tools\Binn。 您可以從檔案系統上的任何資料夾執行此公用程式。

引數

-?
(選擇性) 顯示 rs 引數的語法。

-iinput_file
(必要) 指定要執行的 .rss 檔案。 這個值可以是 .rss 檔案的相對路徑或完整路徑。

-sserverURL
(必要) 指定要對其執行檔案的 Web 伺服器名稱和報表伺服器虛擬目錄名稱。 報表伺服器 URL 的範例為 http://examplewebserver/reportserver。 伺服器名稱開頭的前置詞 http:// 或 https:// 是選擇性的。 如果您省略前置詞，報表伺服器 Script Host 會先嘗試使用 https，而且如果 https 無法運作，則會使用 http。

-u [domain\]username
(選擇性) 指定用來連接到報表伺服器的使用者帳戶。 如果 -u 省略 和 -p ，則會使用目前的 Windows 用戶帳戶。

-p密碼
（如果 -u 已指定，則為必要項） 指定要與 自變數搭配 -u 使用的密碼。 此值區分大小寫。

-e
(選擇性) 指定要在其上執行指令碼的 SOAP 結束點。 有效的值如下：

  • Mgmt2010

  • Mgmt2006

  • Mgmt2005

  • Exec2005

如果未指定值，則會使用 Mgmt2005 端點。 如需有關 SOAP 端點的詳細資訊，請參閱＜ Report Server Web Service Endpoints＞。

-ltime_out
(選擇性) 指定與伺服器的連接逾時之前所經過的秒數。預設值是 60 秒。 若未指定逾時值，則使用預設值。 的值 0 指定連接永遠不會逾時。

-b
(選擇性) 指定以批次方式執行指令檔中的命令。 若有任何命令失敗，便會回復此批次。 有些命令無法批次處理，而會依平常方式執行。 只有在指令碼中發生未處理的例外狀況會導致批次復原。 如果腳本處理例外狀況並正常從 Main傳回 ，則會認可批次。 如果忽略此參數，則會執行此命令而不會建立批次。 如需詳細資訊，請參閱 Batching Methods。

-vglobalvar
(選擇性) 指定在指令碼中使用的全域變數。 如果指令碼使用全域變數，則必須指定此引數。 指定的值必須是 .rss 檔案中所定義的全域變數之有效值。 您必須為每個 -v 引數指定一個全域變數。

自 -v 變數是在命令行上指定，用來設定運行時間腳本中定義之全域變數的值。 例如，如果您的指令碼包含名為 parentFolder的變數，您就可以在命令列上指定該資料夾的名稱：

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

全域變數會使用給定的名稱來建立並設定為所提供的值。 例如，-v a=“1” -v b=“2” 會產生名為 a 且值為 “1” 的變數，而變數 b 的值為 “2”。

指令碼中的任何函數均可使用全域變數。 反斜線和引號 (\") 將被解譯為雙引號。 只有當字串含有空格時才需要引號。 變數名稱必須是 Microsoft Visual Basic 的有效名稱；這些名稱必須以字母字元或底線符號為開頭，且包含字母字元、數字或底線。 保留字不可以當做變數名稱使用。 如需使用全域變數的詳細資訊，請參閱運算式中的內建集合 (報表產生器及 SSRS)。

-t
(選擇性) 追蹤記錄的輸出錯誤訊息。 此引數沒有取得值。 如需詳細資訊，請參閱 Report Server Service Trace Log。

權限

若要執行工具，您必須有足夠的權限，可以連接到要對其執行指令碼的報表伺服器執行個體。 您可以執行指令碼在本機電腦或遠端電腦執行變更。 若要變更安裝在遠端電腦上的報表伺服器，請在 自變數中 -s 指定遠端電腦。

範例

下列範例說明如何指定指令檔，其中包含您要執行的 Visual Basic .NET 指令碼和 Web 服務方法。

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

如需詳細範例，請參閱 範例 Reporting Services rs.exe腳本，以在報表伺服器之間移轉內容。

如需其他範例，請參閱 執行 Reporting Services 指令碼檔案

備註

您可以定義指令碼來設定系統屬性、發行報表等等。 您建立的指令碼可以包括 Reporting Services API 的任何方法。 如需有關可供您使用的方法和屬性之詳細資訊，請參閱＜ Report Server Web Service＞。

指令碼必須以 Visual Basic .NET 程式碼撰寫，然後使用 .rss 副檔名將指令碼儲存在 Unicode 或 UTF-8 文字檔中。 您不可以使用 rs 公用程式來偵錯指令碼。 若要對指令碼進行偵錯，請在 Microsoft Visual Studio 中執行該程式碼。

提示

如需詳細範例，請參閱 範例 Reporting Services rs.exe腳本，以在報表伺服器之間移轉內容。

另請參閱

執行 Reporting Services 指令碼檔案
編寫部署和管理工作的指令碼
利用 rs.exe 公用程式與 Web 服務編寫指令碼
報表伺服器命令提示字元公用程式 (SSRS)