rs 公用程式
處理您在輸入檔中所提供的指令碼。使用此公用程式可自動化報表伺服器部署和管理工作。
重要事項: |
---|
設定為使用 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 正常地傳回,則會認可該批次。如果忽略此參數,則會執行此命令而不會建立批次。如需詳細資訊,請參閱<Batching Methods>。
- -e
(選擇性) 指定要在其上執行指令碼的 SOAP 結束點。有效值包括:Exec2005、Mgmt2005 和 Mgmt2000。如果未指定值,則會使用 Mgmt2005 結束點。請注意,Mgmt2000 值在這一版本中已被取代。如需有關 SOAP 結束點和已被取代功能的詳細資訊,請參閱<Report Server Web Service Endpoints>和<SQL Server 2005 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"。
指令碼中的任何函數均可使用全域變數。反斜線和引號 (\") 將被解譯為雙引號。只有當字串含有空格時才需要引號。變數名稱必須是 Microsoft Visual Basic 的有效名稱;它們必須以字母字元或底線符號為開頭,而且包含字母字元、數字或底線符號。保留字不可以當做變數名稱使用。如需有關使用全域變數的詳細資訊,請參閱<在運算式中使用全域集合 (Reporting Services)>。
- -t
(選擇性) 追蹤記錄的輸出錯誤訊息。此引數沒有取得值。如需詳細資訊,請參閱<Reporting Services 追蹤記錄>。
權限
若要執行工具,您必須有足夠的權限,可以連接到要對其執行指令碼的報表伺服器執行個體。您可以執行指令碼在本機電腦或遠端電腦執行變更。若要對安裝在遠端電腦上的報表伺服器執行變更,請在 -s 引數中指定遠端電腦。
範例
下列範例說明如何指定指令碼檔案,其中包含您要執行的 Visual Basic .NET 指令碼和 Web 服務方法。
rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
附註: |
---|
Reporting Services 包含多個範例指令碼檔案,可讓您用來瞭解如何在 Visual Basic .NET 指令碼中納入報表伺服器 Web 服務的方法。如需詳細資訊,請參閱<指令碼範例 (Reporting Services)>。 |
檔案位置
Rs.exe 位在 \Program Files\Microsoft SQL Server\90\Tools\Binn。您可以從檔案系統上的任何資料夾執行公用程式。
備註
您可以定義指令碼來設定系統屬性、發行報表等等。您所建立的指令碼可包含 Reporting Services 應用程式發展介面的任何方法。如需有關可供您使用的方法和屬性之詳細資訊,請參閱<Report Server Web Service>。
指令碼必須以 Visual Basic .NET 程式碼來撰寫,並儲存成副檔名為 .rss 的 Unicode 或 UTF-8 文字檔。您不可以使用 rs 公用程式來偵錯指令碼。若要偵錯指令碼,請從 Microsoft Visual Studio 中執行程式碼。
請參閱
其他資源
Running a Reporting Services Script File
編寫部署和管理工作的指令碼
Scripting with the rs Utility and the Web Service
報表伺服器命令提示字元公用程式