COM+ サービス モデル構成コマンド ライン ツール (ComSvcConfig.exe) を使用すると、COM+ インターフェイスを Web サービスとして公開するように構成できます。
構文
ComSvcConfig.exe /install | /uninstall | /list [/application:<ApplicationID | ApplicationName>] [/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *>] [/hosting:<complus | was>] [/webSite:<WebsiteName>] [/webDirectory:<WebDirectoryName>] [/mex] [/id] [/nologo] [/verbose] [/help] [/partial]
注釈
注
ComSvcConfig.exeを使用するには、ローカル コンピューターの管理者である必要があります。
ツールは次の場所にあります。
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
ComSvcConfig.exeの詳細については、「 方法: COM+ サービス モデル構成ツールを使用する」を参照してください。
次の表では、ComSvcConfig.exeで使用できるモードについて説明します。
| 選択肢 | 説明 |
|---|---|
install |
サービス モデル統合用の COM+ インターフェイスの構成をインストールします。 短縮形 : /i。 |
uninstall |
COM+ インターフェイスの構成をサービス モデル統合からアンインストールします。 短縮形 : /u。 |
list |
サービス モデル統合用に構成されたインターフェイスを持つ COM+ アプリケーションとコンポーネントに関する情報を一覧表示します。 短縮形 : /l。 |
次の表では、ComSvcConfig.exeで使用できるフラグについて説明します。
| 選択肢 | 説明 |
|---|---|
/application:
<
ApplicationID | ApplicationName> |
構成する COM+ アプリケーションを指定します。 短縮形 : /a。 |
/contract:
<
ClassID | ProgID |*,InterfaceID | InterfaceName | *> |
サービスのコントラクトとして構成される COM+ コンポーネントとインターフェイスを指定します。 短縮形 : /c。コンポーネント名とインターフェイス名を指定するときにワイルドカード文字 (*) を使用できますが、意図していないインターフェイスを公開する可能性があるため、使用しないことをお勧めします。 |
/hosting:
<
complus | は> |
COM+ ホスティング モードと Web ホスティング モードのどちらを使用するかを指定します。 短縮形 : /h。COM+ ホスティング モードを使用するには、COM+ アプリケーションを明示的にアクティブ化する必要があります。 Web ホスティング モードを使用すると、COM+ アプリケーションを必要に応じて自動的にアクティブ化できます。 COM+ アプリケーションがライブラリ アプリケーションの場合は、インターネット インフォメーション サービス (IIS) プロセスで実行されます。 COM+ アプリケーションがサーバー アプリケーションの場合は、Dllhost.exe プロセスで実行されます。 |
/webSite:
<
WebsiteName> |
Web ホスティング モードを使用するときにホストする Web サイトを指定します ( /hosting フラグを参照)。短縮形 : /w。Web サイトが指定されていない場合は、既定の Web サイトが使用されます。 |
/webDirectory:
<
WebDirectoryName> |
Web ホスティングを使用するときにホストする仮想ディレクトリを指定します ( /hosting フラグを参照)。短縮形 : /d。 |
/mex |
メタデータ Exchange (MEX) サービス エンドポイントを既定のサービス構成に追加して、サービスからコントラクト定義を取得するクライアントをサポートします。 短縮形 : /x。 |
/id |
アプリケーション、コンポーネント、およびインターフェイスの情報を ID として表示します。 短縮形 : /k。 |
/nologo |
ComSvcConfig.exe がロゴを表示できないようにします。 短縮形 : /n。 |
/verbose |
発生したエラーに加えて、すべての警告または情報テキストを出力します。 短縮形 : /v。 |
/help |
使用状況メッセージを表示します。 短縮形 : /?。 |
/partial |
指定したインターフェイスに、公開できる 1 つ以上のメソッド シグネチャが含まれている場合に、サービス構成を生成します。 サービスの初期化時に、互換性のあるメソッドはサービス コントラクトに対する操作として表示され、互換性のないメソッドは無視され、サービス コントラクトには存在しません。 このフラグがない場合、指定したインターフェイスに 1 つ以上の互換性のないメソッドが含まれている場合、ツールはサービス構成を生成しません。 |
例示
説明
次の例では、(OnlineStore COM+ アプリケーションから) IFinances コンポーネントのItemOrders.IFinancial インターフェイスを、COM+ ホスティング モードを使用して Web サービスとして公開されるインターフェイスのセットに追加します。 発生したエラーに加えて、すべての警告が出力されます。
コード
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
説明
次の例では、Web ホスティング モードを使用して、IStockLevels コンポーネントの ItemInventory.Warehouse インターフェイス (OnlineWarehouse COM+ アプリケーションから) を Web サービスとして公開されるインターフェイスのセットに追加します。 Web サービスは、IIS の OnlineWarehouse 仮想ディレクトリでホストされている Web です。
コード
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
説明
次の例では、(OnlineStore COM+ アプリケーションから) IFinances コンポーネントのItemOrders.Financial インターフェイスを、Web サービスとして公開されているインターフェイスのセットから削除します。
コード
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
説明
次の例では、ローカル コンピューター上の OnlineStore COM+ アプリケーションに対して、現在公開されている COM+ ホストインターフェイスと、対応するアドレスとバインドの詳細を一覧表示します。
コード
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus