COM+ Service Model Configuration Tool (ComSvcConfig.exe)
Met het opdrachtregelprogramma com+-servicemodelconfiguratie (ComSvcConfig.exe) kunt u COM+ interfaces configureren die als webservices worden weergegeven.
Syntaxis
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]
Opmerkingen
Notitie
U moet een beheerder op de lokale computer zijn om ComSvcConfig.exe te kunnen gebruiken.
Het hulpprogramma is te vinden op de volgende locatie
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Zie Procedures voor meer informatie over ComSvcConfig.exe: Het com+ servicemodelconfiguratieprogramma gebruiken.
In de volgende tabel worden de modi beschreven die kunnen worden gebruikt met ComSvcConfig.exe.
| Optie | Omschrijving |
|---|---|
install |
Hiermee installeert u een configuratie voor een COM+-interface voor servicemodelintegratie. Korte vorm /i. |
uninstall |
Hiermee verwijdert u een configuratie voor een COM+-interface van servicemodelintegratie. Korte vorm /u. |
list |
Bevat informatie over COM+-toepassingen en -onderdelen met interfaces die zijn geconfigureerd voor servicemodelintegratie. Korte vorm /l. |
In de volgende tabel worden de vlaggen beschreven die kunnen worden gebruikt met ComSvcConfig.exe.
| Optie | Omschrijving |
|---|---|
/application:<ApplicationID | ApplicationName> |
Hiermee geeft u de COM+ toepassing te configureren. Korte vorm /a. |
/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Hiermee geeft u het COM+-onderdeel en de interface op die worden geconfigureerd als het contract voor de service. Korte vorm /c.Hoewel het jokerteken (*) kan worden gebruikt wanneer u de namen van het onderdeel en de interface opgeeft, wordt u aangeraden het niet te gebruiken, omdat u mogelijk interfaces weergeeft die u niet van plan was. |
/hosting:<complus | was> |
Hiermee geeft u op of de COM+ hostingmodus of de webhostingmodus moet worden gebruikt. Korte vorm /h.Voor het gebruik van de COM+-hostingmodus is expliciete activering van de COM+-toepassing vereist. Als u de webhostingmodus gebruikt, kan de COM+-toepassing automatisch worden geactiveerd zoals vereist. Als de COM+-toepassing een bibliotheektoepassing is, wordt deze uitgevoerd in het IIS-proces (Internet Information Services). Als de COM+-toepassing een servertoepassing is, wordt deze uitgevoerd in het Dllhost.exe proces. |
/webSite:<WebsiteNaam> |
Hiermee geeft u de website voor het hosten wanneer de webhostingmodus wordt gebruikt (zie de /hosting vlag).Korte vorm /w.Als er geen website is opgegeven, wordt de standaardwebsite gebruikt. |
/webDirectory:<WebDirectoryName> |
Hiermee geeft u de virtuele map voor hosting wanneer webhosting wordt gebruikt (zie de /hosting vlag).Korte vorm /d. |
/mex |
Voegt een MEX-service-eindpunt (Metadata Exchange) toe aan de standaardserviceconfiguratie ter ondersteuning van clients die een contractdefinitie van de service willen ophalen. Korte vorm /x. |
/id |
Geeft de toepassings-, onderdeel- en interfacegegevens weer als id's. Korte vorm /k. |
/nologo |
Hiermee voorkomt u dat ComSvcConfig.exe het bijbehorende logo weergeeft. Korte vorm /n. |
/verbose |
Voert alle waarschuwingen of informatieve tekst uit naast eventuele fouten die zijn opgetreden. Korte vorm /v. |
/help |
Geeft het gebruiksbericht weer. Korte vorm /?. |
/partial |
Hiermee wordt een serviceconfiguratie gegenereerd wanneer de opgegeven interface een of meer methodehandtekeningen bevat die kunnen worden weergegeven. Tijdens de initialisatietijd van de service worden compatibele methoden weergegeven als bewerkingen in het servicecontract en worden niet-compatibele methoden genegeerd en afwezig van het servicecontract. Als deze vlag ontbreekt, genereert het hulpprogramma geen serviceconfiguratie wanneer de opgegeven interface een of meer niet-compatibele methoden bevat. |
Voorbeelden
Beschrijving
In het volgende voorbeeld wordt de IFinances interface van het ItemOrders.IFinancial onderdeel (van de OnlineStore COM+-toepassing) toegevoegd aan de set interfaces die beschikbaar worden gesteld als webservices, met behulp van de COM+ hostingmodus. Alle waarschuwingen worden uitgevoerd naast eventuele fouten die zijn opgetreden.
Code
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Beschrijving
In het volgende voorbeeld wordt de IStockLevels interface van het ItemInventory.Warehouse onderdeel (van de OnlineWarehouse COM+-toepassing) toegevoegd aan de set interfaces die beschikbaar worden gesteld als webservices, met behulp van de webhostingmodus. De webservice wordt gehost in de virtuele map OnlineWarehouse van IIS.
Code
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
Beschrijving
In het volgende voorbeeld wordt de IFinances interface van het ItemOrders.Financial onderdeel (uit de OnlineStore COM+-toepassing) verwijderd uit de set interfaces die als webservices worden weergegeven.
Code
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Beschrijving
In het volgende voorbeeld worden momenteel com+ gehoste interfaces weergegeven, samen met het bijbehorende adres en de bijbehorende bindingsgegevens, voor de OnlineStore COM+ toepassing op de lokale computer.
Code
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus