rs ユーティリティ
入力ファイル内に指定したスクリプトを処理します。このユーティリティを使用して、レポート サーバーの配置と管理タスクを自動化します。
.gif "ms162839.note(ja-jp,SQL.90).gif") 重要 : |
|---|
| rs ユーティリティは、SharePoint 統合モード用に構成されているレポート サーバーに対してはサポートされません。 |
構文
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:// は省略可能です。プレフィックスを省略した場合、レポート サーバーのスクリプト ホストは、まず https の使用を試み、https が使用できない場合は、http を使用します。
- -u [domain\] username
(省略可) レポート サーバーへの接続に使用するユーザー アカウントを指定します。-u および -p を省略した場合、現在の Windows ユーザー アカウントが使用されます。
- -ppassword
(-u を指定した場合は必須) -u 引数で使用するパスワードを指定します。この値は、大文字と小文字が区別されます。
- -ltime_out
(省略可) サーバーへの接続がタイムアウトするまでの期間を秒数で指定します。既定値は 60 秒です。タイムアウト値を指定しない場合、既定値が使用されます。値が 0 の場合は、接続はタイムアウトしません。
- -b
(省略可) スクリプト ファイル内のコマンドをバッチで実行します。いずれかのコマンドが失敗すると、バッチはロールバックされます。バッチで実行できないコマンドがありますが、それらのコマンドは通常どおり実行されます。スクリプト内でスローされるが処理されない例外だけが、ロールバックされます。スクリプトによって例外が処理され、Main から正常に値が返された場合、バッチはコミットされます。このパラメータを省略した場合、バッチを作成せずにコマンドが実行されます。詳細については、「メソッドのバッチ処理」を参照してください。
- -e
(省略可) スクリプトを実行する SOAP エンドポイントを指定します。有効な値は Exec2005、Mgmt2005、Mgmt2000 です。値が指定されていない場合は、Mgmt2005 エンドポイントが使用されます。Mgmt2000 はこのリリースでは推奨されていない点に注意してください。SOAP エンドポイントと非推奨機能の詳細については、「レポート サーバー Web サービスのエンドポイント」と「SQL Server 2005 Reporting Services の非推奨機能」を参照してください。
-vglobalvar
(省略可) スクリプト内で使用するグローバル変数を指定します。スクリプトでグローバル変数を使用する場合は、この引数を指定する必要があります。.rss ファイルで定義したグローバル変数に対して有効な値を指定する必要があります。–v 引数ごとに 1 つのグローバル変数を指定できます。-v は、コマンド ラインで指定する引数で、スクリプト内で定義されているグローバル変数の値を実行時に設定するために使用します。たとえば、parentFolder という名前の変数がスクリプトに含まれている場合は、そのフォルダの名前をコマンド ラインで指定できます。
rs.exe -i myScriptFile.rss -s http://myServer/reportserver -v parentFolder="Financial Reports"指定した値に設定された名前を使用して、グローバル変数を作成します。たとえば、 -v a="1" -v b="2" は、 "1" という値を持つ a という名前の変数と、"2" という値を持つ b という変数を表します。
グローバル変数は、スクリプト内のすべての関数で使用できます。円記号と引用符 (\") は、二重引用符と解釈されます。引用符は、文字列にスペースが含まれている場合のみ必要です。変数名は、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 アプリケーション プログラミング インターフェイスの任意のメソッドを含めることができます。使用可能なメソッドおよびプロパティの詳細については、「レポート サーバー Web サービス」を参照してください。
スクリプトは、Visual Basic .NET のコードで記述し、.rss ファイル拡張子が付いた Unicode または UTF-8 テキスト ファイルとして保存する必要があります。rs ユーティリティを使用して、スクリプトをデバッグすることはできません。スクリプトをデバッグするには、Microsoft Visual Studio 内からコードを実行します。
参照
その他の技術情報
Reporting Services スクリプト ファイルの実行
配置タスクおよび管理タスクのためのスクリプト作成
rs ユーティリティと Web サービスを使用したスクリプト
レポート サーバーのコマンド プロンプト ユーティリティ