rs 公用程式

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

ms162839.note(zh-tw,SQL.90).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 正常地傳回,則會認可該批次。如果忽略此參數,則會執行此命令而不會建立批次。如需詳細資訊,請參閱<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 的有效名稱;它們必須以字母字元或底線符號為開頭,而且包含字母字元、數字或底線符號。保留字不可以當做變數名稱使用。如需有關使用全域變數的詳細資訊,請參閱<在運算式中使用全域集合 (Reporting Services)>。

權限

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

範例

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

rs –i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver
ms162839.note(zh-tw,SQL.90).gif附註:
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
報表伺服器命令提示字元公用程式

說明及資訊

取得 SQL Server 2005 協助