http://msdn.microsoft.com/zh-cn/library/ms162839.aspx
rs 實用工具 (rs.exe) (SSRS)
其他版本
- SQL Server 2008 R2
- SQL Server 2008
- SQL Server 2005
此主題尚未評級- 評價此主題
處理輸入檔案中提供的腳本。 使用此實用工具，可以實作報表伺服器部署與管理任務的自動化。
 |
|---|
| 從 SQL Server 2008 R2 開始，配置為 SharePoint 內建模式的報表伺服器以及配置為本機模式的伺服器均支援rs 實用工具。 以前的版本僅支援本機模式配置。 |
文法 複制
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:// 是可選的。 如果省略字首，報表伺服器腳本主機将先嘗試使用 https，并在 https 無效時使用 http。 -u [ domain\] username
- （可選）指定用于連接配接到報表伺服器的使用者帳戶。 如果省略 -u 和 -p，則使用目前的 Windows 使用者帳戶。 -p password
- （指定了 -u 時為必需）指定與-u 參數一起使用的密碼。 此值區分大小寫。 -e
- （可選）指定應對其運作腳本的 SOAP 端點。 有效值如下：
- Mgmt2010
- Mgmt2006
- Mgmt2005
- Exec2005
-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”的變量，以及一個值為“2”的變量b。
全局變量可用于腳本中的所有函數。 反斜杠與英文引号連用 (\") 将轉義為一個英文雙引号。 僅當字元串中包含空格時才需要使用英文引号。 變量名必須對 Microsoft Visual Basic 有效；變量名必須以字母字元或下劃線開頭，并包含字母字元、數字或下劃線。不能将保留字用作變量名。 有關使用全局變量的詳細資訊，請參閱表達式中的内置集合（報表生成器和 SSRS）。
-t - （可選）将錯誤資訊輸出到跟蹤日志中。 此參數不帶值。 有關詳細資訊，請參閱 報表伺服器服務跟蹤日志。
權限
若要運作該工具，必須擁有與運作腳本的報表伺服器執行個體連接配接的權限。 可以運作腳本來更改本地計算機或遠端計算機。 若要更改遠端計算機上的報表伺服器，請在-s 參數中指定遠端計算機。
示例
以下示例說明了如何指定包含 Visual Basic .NET 腳本的腳本檔案以及要執行的 Web 服務方法。
複制
rs –i c:\scriptfiles\script_copycontent.rss -s http://localhost/reportserver
有關其他示例，請參閱 運作 Reporting Services 腳本檔案。
注釋
可以定義腳本來設定系統屬性，釋出報表，等等。 所建立的腳本可以包含 Reporting Services API 的任何方法。 有關可以使用的方法和屬性的詳細資訊，請參閱報表伺服器 Web 服務。
必須用 Visual Basic .NET 代碼編寫腳本，并存儲在檔案擴充名為 .rss 的 Unicode 或 UTF-8 文本檔案中。不能使用 rs 實用工具調試腳本。 若要調試腳本，請在 Microsoft Visual Studio 中運作代碼。
請參閱
概念
運作 Reporting Services 腳本檔案 為部署任務和管理任務編寫腳本 報表伺服器指令提示實用工具 (SSRS)
其他資源
使用 rs 實用工具和 Web 服務編寫腳本