RS.exe Utility (SSRS)

[アーティクル]
06/13/2017

rs.exe ユーティリティは入力ファイル内に指定したスクリプトを処理します。このユーティリティを使用して、レポートサーバーの配置と管理タスクを自動化します。

Note

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 の引数の構文を表示します。

-iinput_file
(必須) 実行する .rss ファイルを指定します。この値は、.rss ファイルへの相対パスまたは完全修飾パスになります。

-sserverURL
(必須) Web サーバー名とレポートサーバーの仮想ディレクトリ名を指定して、対象ファイルを実行します。レポートサーバーの URL は、 http://examplewebserver/reportserverのように指定します。サーバー名の先頭のプレフィックス http:// または https:// は省略可能です。プレフィックスを省略した場合、レポートサーバーのスクリプトホストは、まず https の使用を試み、https が使用できない場合は、http を使用します。

-u [domain\]username
(省略可) レポートサーバーへの接続に使用するユーザーアカウントを指定します。 -u および -p を省略した場合、現在の Windows ユーザーアカウントが使用されます。

-ppassword
(-u を指定した場合は必須) -u 引数で使用するパスワードを指定します。この値は、大文字と小文字が区別されます。

-e
(省略可) スクリプトを実行する SOAP エンドポイントを指定します。有効な値は次のとおりです。

Mgmt2010
Mgmt2006
Mgmt2005
Exec2005

値が指定されていない場合は、Mgmt2005 エンドポイントが使用されます。 SOAP エンドポイントの詳細については、「 Report Server Web Service Endpoints」を参照してください。

-ltime_out
(省略可) サーバーへの接続がタイムアウトするまでの期間を秒数で指定します。既定値は 60 秒です。タイムアウト値を指定しない場合、既定値が使用されます。値が 0 の場合は、接続はタイムアウトしません。

-b
(省略可) スクリプトファイル内のコマンドをバッチで実行します。いずれかのコマンドが失敗すると、バッチはロールバックされます。バッチで実行できないコマンドがありますが、それらのコマンドは通常どおり実行されます。スクリプト内でスローされるが処理されない例外だけが、ロールバックされます。スクリプトによって例外が処理され、Main から正常に値が返された場合、バッチはコミットされます。このパラメーターを省略した場合、バッチを作成せずにコマンドが実行されます。詳細については、「 Batching Methods」をご参照ください。

-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 で有効な名前であることが必要です。また変数名は、アルファベットやアンダースコアで始まり、アルファベット文字、数字、およびアンダースコアを含めることができます。予約語は、変数名として使用できません。グローバル変数の使用の詳細については、「式で使用される組み込みコレクション (レポートビルダーおよび SSRS)」を参照してください。

-t
(省略可) エラーメッセージをトレースログに出力します。この引数は値を取りません。詳細については、「 Report Server Service Trace Log」を参照してください。

アクセス許可

ツールを実行するには、スクリプトの実行対象であるレポートサーバーインスタンスに接続するための権限が必要です。スクリプトを実行して、ローカルコンピューターまたはリモートコンピューターに変更を加えることができます。リモートコンピューターにインストールしたレポートサーバーを変更するには、-s 引数でリモートコンピューターを指定します。

例

次の例では、実行する Visual Basic .NET スクリプト、および Web サービスメソッドを含むスクリプトファイルの指定方法を示しています。

rs -i c:\scriptfiles\script_copycontent.rss -s https://localhost/reportserver

詳細な例については、「 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers」を参照してください。

その他の例については、「 Reporting Services スクリプトファイルを実行する」を参照してください。

解説

スクリプトを定義して、システムプロパティの設定、レポートのパブリッシュなどが行えます。作成したスクリプトには、 Reporting Services API の任意のメソッドを含めることができます。使用可能なメソッドおよびプロパティの詳細については、「 Report Server Web Service」を参照してください。

スクリプトは、 Visual Basic .NET のコードで記述し、.rss ファイル名拡張子が付いた Unicode または UTF-8 テキストファイルとして保存する必要があります。 rs ユーティリティを使用して、スクリプトをデバッグすることはできません。スクリプトをデバッグするには、Microsoft Visual Studio 内でコードを実行します。

ヒント

詳細な例については、「 Sample Reporting Services rs.exe Script to Migrate Content between Report Servers」を参照してください。

参照

Reporting Services スクリプトファイルを実行する
 配置タスクおよび管理タスクのスクリプト作成
 rs.exe ユーティリティと Web サービスを使用したスクリプト
 レポートサーバーのコマンドプロンプトユーティリティ (SSRS)

次の方法で共有

RS.exe Utility (SSRS)

構文

ファイルの場所

引数

アクセス許可

例

解説

参照

その他のリソース