Программа командной строки настройки модели служб COM+ (ComSvcConfig.exe)
Программа командной строки для настройки модели служб COM+ (ComSvcConfig.exe) позволяет настраивать интерфейсы COM+, которые нужно предоставить как веб-службы.
Синтаксис
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 на компьютере под управлением ОС Windows Vista требуются права администратора.
Это средство можно найти в следующей папке:
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Дополнительные сведения о ComSvcConfig.exe см. в статье "Практическое руководство. Использование средства конфигурации модели службы COM+ ".
В следующей таблице представлены режимы, которые могут использоваться с ComSvcConfig.exe.
| Вариант | Описание |
|---|---|
install |
Устанавливает конфигурацию для интерфейса COM+ для интеграции Service Model. Краткая форма: /i. |
uninstall |
Удаляет конфигурацию для интерфейса COM+ из интеграции Service Model. Краткая форма: /u. |
list |
Отображает сведения о приложениях и компонентах COM+, которые имеют интерфейсы, настроенные для интеграции Service Model. Краткая форма: /l. |
В следующей таблице представлены флаги, которые могут использоваться с ComSvcConfig.exe.
| Вариант | Описание |
|---|---|
/application:<ApplicationID | ApplicationName> |
Позволяет указать приложение COM+ для настройки. Краткая форма: /a. |
/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Позволяет указать компонент и интерфейс COM+, которые будут настроены в качестве контракта для службы. Краткая форма: /c.Хотя дикий карта символ (*) можно использовать при указании имен компонентов и интерфейсов, рекомендуется не использовать его, так как вы можете предоставлять интерфейсы, которые вы не намеревались использовать. |
/hosting:<complus | был> |
Позволяет указать необходимость использования режима размещения COM+ или режима размещения на веб-сервере. Краткая форма: /h.Для использования режима размещения COM+ требуется явная активация приложения COM+. Использование режима размещения на веб-сервере позволяет автоматически активировать приложение COM+ при необходимости. Если приложение COM+ является библиотечным приложением, оно выполняется в процессе IIS. Если приложение COM+ является серверным приложением, оно выполняется в процессе Dllhost.exe. |
/webSite:<Имя веб-сайта> |
Позволяет указать веб-сайт для размещения при использовании режима размещения на веб-сервере (см. флаг /hosting).Краткая форма: /w.Если веб-сайт не указан, используется веб-сайт по умолчанию. |
/webDirectory:<WebDirectoryName> |
Позволяет указать виртуальный каталог для размещения при использовании режима размещения на веб-сервере (см. флаг /hosting).Краткая форма: /d. |
/mex |
Добавляет конечную точку службы обмена метаданными в конфигурацию службы по умолчанию для поддержки клиентов, которым требуется извлечь определение контракта из службы. Краткая форма: /x. |
/id |
Отображает информацию о приложении, компоненте и интерфейсе в виде идентификаторов. Краткая форма: /k. |
/nologo |
Подавляет отображение логотипа ComSvcConfig.exe. Краткая форма: /n. |
/verbose |
Выводит все предупреждения или информационный текст в дополнение к любым обнаруженным ошибкам. Краткая форма: /v. |
/help |
Отображает сообщение об использовании. Краткая форма: /?. |
/partial |
Создает конфигурацию службы, если указанный интерфейс включает одну или несколько сигнатур метода, которые могут быть предоставлены для использования. Во время инициализации службы совместимые методы отображаются как операции над контрактом службы, а несовместимые методы игнорируются и исключаются из контракта службы. Если данный флаг отсутствует, средство не создает конфигурацию службы, когда указанный интерфейс включает один или несколько несовместимых методов. |
Примеры
Description
В следующем примере с помощью режима размещения COM+ выполняется добавление интерфейса IFinances компонента ItemOrders.IFinancial (из приложения COM+ OnlineStore) в набор интерфейсов, предоставляемых как веб-службы. В дополнение к любым обнаруженным ошибкам выводятся все предупреждения.
Код
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Описание
В следующем примере с помощью режима размещения на веб-сервере выполняется добавление интерфейса IStockLevels компонента ItemInventory.Warehouse (из приложения COM+ OnlineWarehouse) в набор интерфейсов, предоставляемых как веб-службы. Веб-служба размещается в виртуальном каталоге OnlineWarehouse в IIS.
Код
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
Описание
В следующем примере выполняется удаление интерфейса IFinances компонента ItemOrders.Financial (из приложения COM+ OnlineStore) из набора интерфейсов, предоставляемых как веб-службы.
Код
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Описание
В следующем примере выводится список предоставляемых в данный момент интерфейсов, размещенных в COM+, а также соответствующий адрес и сведения о привязке для приложения COM+ OnlineStore на локальном компьютере.
Код
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus