.NET サービス インストール ツール (Regsvcs.exe)
更新 : 2007 年 11 月
.NET サービス インストール ツールは、次のアクションを実行します。
アセンブリの読み込みと登録。
タイプ ライブラリの生成、登録、および指定された COM+ 1.0 アプリケーションへのインストール。
プログラムでクラスに追加したサービスの設定。
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
パラメータ
引数 |
説明 |
|---|---|
assemblyFile.dll |
ソース アセンブリ ファイル。アセンブリは、厳密な名前で署名する必要があります。詳細については、「厳密な名前でのアセンブリへの署名」を参照してください。 |
オプション |
説明 |
|---|---|
/appdir:path |
アプリケーションのルート ディレクトリを示します。 |
/appname:applicationName |
検索または作成する COM+ 1.0 アプリケーションの名前を指定します。 |
/c |
対象アプリケーションを作成します。 |
/componly |
コンポーネントだけを設定します。メソッドとインターフェイスは無視されます。 |
/exapp |
このツールが既存のアプリケーションを要求するように指定します。 |
/extlb |
既存のタイプ ライブラリを使用します。 |
/fc |
対象アプリケーションを検索または作成します。 |
/help |
このツールのコマンド構文とオプションを表示します。 |
/noreconfig |
既存の対象アプリケーションを再設定しません。 |
/nologo |
Microsoft 著作権情報を表示しません。 |
/parname:name |
検索または作成する COM+ 1.0 アプリケーションの名前または ID を指定します。 |
/reconfig |
既存の対象アプリケーションを再設定します。これは、既定の設定です。 |
/tlb:typelibraryfile |
インストールするタイプ ライブラリ ファイルを指定します。 |
/u |
対象アプリケーションをアンインストールします。 |
/quiet |
クワイエット モードを指定します。ロゴと成功メッセージは表示されません。 |
/? |
このツールのコマンド構文とオプションを表示します。 |
解説
Regsvcs.exe には、assemblyFile.dll で指定されているソース アセンブリ ファイルが必要です。このアセンブリは、厳密な名前で署名する必要があります。厳密な名前での署名の詳細については、「厳密な名前でのアセンブリへの署名」を参照してください。対象アプリケーションおよびタイプ ライブラリの名前は、オプションです。引数 applicationName はソース アセンブリ ファイルから生成できます。存在しない場合は、Regsvcs.exe によって作成されます。引数 typelibraryfile にはタイプ ライブラリ名を指定できます。タイプ ライブラリ名を指定しない場合、Regsvcs.exe は既定値としてアセンブリ名を使用します。
Regsvcs.exe がコンポーネントのメソッドを登録する場合は、それらのメソッドに対する確認要求とリンク確認要求の影響を受けます。このツールは完全に信頼された環境で実行されるため、アクセス許可に対するほとんどの確認要求は成功します。ただし、Regsvcs.exe では、StrongNameIdentityPermission または PublisherIdentityPermission に対する確認要求やリンク確認要求によって保護されたメソッドを含むコンポーネントを登録することはできません。
Regsvcs.exe を使用するには、ローカル コンピュータの管理者特権が必要です。
上記のアクションの実行中に Regsvcs.exe が異常終了した場合は、対応するエラー メッセージが表示されます。発生する可能性のある異常終了とエラー メッセージの詳細については、「アセンブリの手動登録」を参照してください。
例
myTest.dll に含まれるすべてのパブリック クラスを myTargetApp (既存の COM+ 1.0 アプリケーション) に追加し、タイプ ライブラリ myTest.tlb を生成するコマンドを次に示します。
regsvcs /appname:myTargetApp myTest.dll
myTest.dll に含まれるすべてのパブリック クラスを myTargetApp (既存の COM+ 1.0 アプリケーション) に追加し、タイプ ライブラリ newTest.tlb を生成するコマンドを次に示します。
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll