rs 公用程式
處理您在輸入檔中所提供的指令碼。使用此公用程式可自動化報表伺服器部署和管理工作。
.gif "重要注意事項") 重要事項 |
|---|
針對 SharePoint 整合模式所設定的報表伺服器不支援 rs 公用程式。 |
語法
rs {-?}
[-iinput_file=]
[-sserverURL]
{-uusername}
{-ppassword}
{-ltime_out}
{-bbatchmode}
{-vglobalvars=}
{-eendpoint}
{-ttrace}
引數
-?
(選擇性) 顯示 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 引數一起使用的密碼。此值區分大小寫。-ltime_out
(選擇性) 指定與伺服器的連接逾時之前所經過的秒數。預設值是 60 秒。若未指定逾時值，則使用預設值。0 的值指定連接永不逾時。-b
(選擇性) 指定以批次方式執行指令碼檔案中的命令。若有任何命令失敗，便會回復此批次。有些命令無法批次處理，而會依平常方式執行。只有在指令碼中發生未處理的例外狀況會導致批次復原。如果指令碼處理例外狀況並從 Main 正常地傳回，則會認可該批次。如果忽略此參數，則會執行此命令而不會建立批次。如需詳細資訊，請參閱＜批次方法＞。-e
(選擇性) 指定要在其上執行指令碼的 SOAP 結束點。有效值包括 Exec2005 或 Mgmt2005。如果未指定值，則會使用 Mgmt2005 結束點。請注意，Mgmt2000 值在這個版本中已經停止而且不再是有效的值。此外，由於 rs.exe 不支援 SharePoint 整合模式，因此有效值清單不會包括 ReportService2006 端點。如需有關 SOAP 結束點和已被取代功能的詳細資訊，請參閱＜報表伺服器 Web 服務端點＞和＜SQL Server Reporting Services 中已被取代的功能＞。-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"。
指令碼中的任何函數均可使用全域變數。反斜線和引號 (\") 將被解譯為雙引號。只有當字串含有空格時才需要引號。變數名稱必須是 MicrosoftVisual Basic 的有效名稱。它們必須以字母字元或底線符號為開頭，而且包含字母字元、數字或底線符號。保留字不可以當做變數名稱使用。如需有關使用全域變數的詳細資訊，請參閱＜使用運算式中的內建集合 (Reporting Services)＞。
-t
(選擇性) 追蹤記錄的輸出錯誤訊息。此引數沒有取得值。如需詳細資訊，請參閱＜報表伺服器服務追蹤記錄＞。
權限
若要執行工具，您必須有足夠的權限，可以連接到要對其執行指令碼的報表伺服器執行個體。您可以執行指令碼在本機電腦或遠端電腦執行變更。若要對安裝在遠端電腦上的報表伺服器執行變更，請在 -s 引數中指定遠端電腦。
範例
下列範例說明如何指定指令碼檔案，其中包含您要執行的 Visual Basic .NET 指令碼和 Web 服務方法。
rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
[!附註]
Reporting Services 包含多個範例指令碼檔案，可讓您用來瞭解如何在 Visual Basic .NET 指令碼中納入報表伺服器 Web 服務的方法。如需詳細資訊，請參閱＜Sample Scripts＞。
檔案位置
Rs.exe 位在 \Program Files\Microsoft SQL Server\100\Tools\Binn。您可以從檔案系統上的任何資料夾執行公用程式。
備註
您可以定義指令碼來設定系統屬性、發行報表等等。您可以建立的指令碼包括 Reporting Services API 的任何方法。如需有關可供您使用的方法和屬性之詳細資訊，請參閱＜報表伺服器 Web 服務＞。
指令碼必須以 Visual Basic .NET 程式碼來撰寫，並儲存成副檔名為 .rss 的 Unicode 或 UTF-8 文字檔。您不可以使用 rs 公用程式來偵錯指令碼。若要偵錯指令碼，請在 MicrosoftVisual Studio 中執行該程式碼。