rs 公用程式 (rs.exe) (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 引數的語法。-i input_file
(必要) 指定要執行的 .rss 檔案。 這個值可以是 .rss 檔案的相對路徑或完整路徑。-s serverURL
(必要) 指定要對其執行檔案的 Web 伺服器名稱和報表伺服器虛擬目錄名稱。 報表伺服器 URL 的範例為 http://examplewebserver/reportserver。 伺服器名稱開頭的前置詞 http:// 或 https:// 是選擇性的。 如果您省略前置詞，報表伺服器 Script Host 會先嘗試使用 https，而且如果 https 無法運作，則會使用 http。-u [domain\]username
(選擇性) 指定用來連接到報表伺服器的使用者帳戶。 如果省略 -u 和 -p，則會使用目前的 Windows 使用者帳戶。-p password
(如果已指定 -u 則是必要的) 指定要與 -u 引數一起使用的密碼。 此值區分大小寫。-e
(選擇性) 指定要在其上執行指令碼的 SOAP 結束點。 有效的值如下：Mgmt2010
Mgmt2006
Mgmt2005
Exec2005
如果未指定值，則會使用 Mgmt2005 端點。 請注意，Mgmt2000 值在這個版本中已經停止而且不再是有效的值。 如需有關 SOAP 端點和已被取代之功能的詳細資訊，請參閱＜報表伺服器 Web 服務端點＞及＜SQL Server 2012 中 SQL Server Reporting Services 已被取代的功能＞
-l time_out
(選擇性) 指定與伺服器的連接逾時之前所經過的秒數。 預設值是 60 秒。 若未指定逾時值，則使用預設值。 0 的值指定連接永不逾時。-b
(選擇性) 指定以批次方式執行指令碼檔案中的命令。 若有任何命令失敗，便會回復此批次。 有些命令無法批次處理，而會依平常方式執行。 只有在指令碼中發生未處理的例外狀況會導致批次復原。 如果指令碼處理例外狀況並從 Main 正常地傳回，則會認可該批次。 如果忽略此參數，則會執行此命令而不會建立批次。 如需詳細資訊，請參閱＜批次方法＞。-v globalvar
(選擇性) 指定在指令碼中使用的全域變數。 如果指令碼使用全域變數，則必須指定此引數。 指定的值必須是 .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
(選擇性) 追蹤記錄的輸出錯誤訊息。 此引數沒有取得值。 如需詳細資訊，請參閱＜報表伺服器服務追蹤記錄＞。
權限
若要執行工具，您必須有足夠的權限，可以連接到要對其執行指令碼的報表伺服器執行個體。 您可以執行指令碼在本機電腦或遠端電腦執行變更。 若要對安裝在遠端電腦上的報表伺服器執行變更，請在 -s 引數中指定遠端電腦。
範例
下列範例說明如何指定指令碼檔案，其中包含您要執行的 Visual Basic .NET 指令碼和 Web 服務方法。
rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
如需詳細的範例，請參閱＜Sample Reporting Services rs.exe Script to Migrate Content between Report Servers＞。
如需其他範例，請參閱＜執行 Reporting Services 指令碼檔案＞。
備註
您可以定義指令碼來設定系統屬性、發行報表等等。 您可以建立的指令碼包括 Reporting Services API 的任何方法。 如需有關可供您使用的方法和屬性之詳細資訊，請參閱＜報表伺服器 Web 服務＞。
指令碼必須以 Visual Basic .NET 程式碼撰寫，然後使用 .rss 附檔名將指令碼儲存在 Unicode 或 UTF-8 文字檔案中。 您不可以使用 rs 公用程式來偵錯指令碼。 若要偵錯指令碼，請在 Microsoft Visual Studio 中執行該程式碼。