Поделиться через


Средство настройки модели 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необходимо быть администратором на локальном компьютере.

Инструмент можно найти в следующем месте.

%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\

Дополнительные сведения о ComSvcConfig.exeсм. в статье "Практическое руководство: использование средства настройки модели COM+ Service Model".

В следующей таблице описаны режимы, которые можно использовать с 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+ или режим веб-размещения.

Короткая форма /h.

Для использования режима размещения COM+ требуется явная активация приложения COM+. Использование режима веб-размещения позволяет приложению COM+ автоматически активироваться по мере необходимости. Если приложение COM+ является приложением библиотеки, оно выполняется в процессе служб IIS. Если приложение COM+ является серверным приложением, оно выполняется в процессе Dllhost.exe.
/webSite: < Имя веб-сайта> Указывает веб-сайт для размещения при использовании режима веб-размещения (см /hosting . флаг).

Короткая форма /w.

Если веб-сайт не указан, используется веб-сайт по умолчанию.
/webDirectory: < WebDirectoryName> Указывает виртуальный каталог для размещения при использовании веб-хостинга (см /hosting, флаг).

Короткая форма /d.
/mex Добавляет конечную точку службы для обмена метаданными (MEX) в конфигурацию службы по умолчанию, чтобы поддерживать клиентов, которые хотят получить определение контракта из службы.

Короткая форма /x.
/id Отображает сведения о приложении, компоненте и интерфейсе в виде идентификаторов.

Короткая форма /k.
/nologo Запрещает ComSvcConfig.exe отображать логотип.

Короткая форма /n.
/verbose Выводит все предупреждения или информационный текст в дополнение к возникшим ошибкам.

Короткая форма /v.
/help Отображает сообщение об использовании.

Короткая форма /?.
/partial Создает конфигурацию службы, когда указанный интерфейс содержит одну или несколько сигнатур методов, которые могут быть опубликованы. Во время инициализации службы совместимые методы отображаются как операции контракта службы, а не совместимые методы игнорируются и отсутствуют в контракте службы.

Если этот флаг отсутствует, средство не создаст конфигурацию службы, если указанный интерфейс включает один или несколько несовместимых методов.

Примеры

Описание

В следующем примере интерфейс IFinances компонента ItemOrders.IFinancial (из приложения COM+ OnlineStore) добавляется к набору интерфейсов, предоставляемых как веб-службы, используя режим размещения COM+. Все предупреждения будут выводиться в дополнение к возникшим ошибкам.

Код

ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose  

Описание

В следующем примере интерфейс IStockLevels компонента ItemInventory.Warehouse (из приложения COM+ OnlineWarehouse) добавляется в набор интерфейсов, предоставляемых как веб-службы, с помощью режима веб-размещения. Веб-служба размещена в виртуальном каталоге Iis OnlineWarehouse.

Код

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+, а также соответствующие сведения об адресе и привязке для приложения OnlineStore COM+ на локальном компьютере.

Код

ComSvcConfig.exe /list /application:OnlineStore /hosting:complus  

См. также