Strumento per la configurazione del modello di servizio di COM+ (ComSvcConfig.exe)
Lo strumento da riga di comando per la configurazione del modello del servizio di COM+ (ComSvcConfig.exe) consente di configurare le interfacce COM+ che si desidera siano esposte come servizi Web.
Sintassi
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]
Osservazioni:
Nota
Per utilizzare ComSvcConfig.exe è necessario disporre dei privilegi di amministratore per il computer.
Lo strumento si trova nel percorso seguente
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Per altre informazioni su ComSvcConfig.exe, vedere Procedura: Usare lo strumento COM+ Service Model Configuration.
Nella tabella riportata di seguito sono descritti le modalità di utilizzo di ComSvcConfig.exe.
| Opzione | Descrizione |
|---|---|
install |
Installa una configurazione per un'interfaccia COM+ per l'integrazione del Modello di servizio. Forma abbreviata /i. |
uninstall |
Disinstalla una configurazione per un'interfaccia COM+ dall'integrazione del Modello di servizio. Forma abbreviata /u. |
list |
Elenca le informazioni su applicazioni e componenti COM+ dotati di interfacce configurate per l'integrazione del Modello di servizio. Forma abbreviata /l. |
Nella tabella riportata di seguito sono descritti i flag che possono essere utilizzati con ComSvcConfig.exe.
| Opzione | Descrizione |
|---|---|
/application:<ApplicationID | ApplicationName> |
Specifica l'applicazione COM+ da configurare. Forma abbreviata /a. |
/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *> |
Specifica componente e interfaccia COM+ che verranno configurati come contratto del servizio. Forma abbreviata /c.Mentre il carattere jolly (*) può essere utilizzato quando si specificano i nomi di componente e interfaccia, si consiglia di non utilizzarlo, in quanto è possibile esporre interfacce che non si desiderava esporre. |
/hosting:<complus | was> |
Specifica se utilizzare la modalità di hosting COM+ o Web. Forma abbreviata /h.L'utilizzo della modalità di hosting COM+ richiede l’attivazione esplicita dell'applicazione COM+. L'utilizzo della modalità di hosting Web, consente l’attivazione automatica dell’applicazione COM+ come necessario. Se l'applicazione COM+ è un'applicazione della libreria, essa viene eseguita nel processo di Internet Information Services (IIS). Se l'applicazione COM+ è un'applicazione server, essa viene eseguita nel processo di Dllhost.exe. |
/webSite:<WebsiteName> |
Specifica il sito Web per l’hosting quando viene utilizzata la modalità di hosting Web (vedere il flag /hosting ).Forma abbreviata /w.Se non viene specificato nessun sito Web, verrà utilizzato il sito Web predefinito. |
/webDirectory:<WebDirectoryName> |
Specifica la directory virtuale per l’hosting quando viene utilizzata la modalità di hosting Web (vedere il flag /hosting ).Forma abbreviata /d. |
/mex |
Aggiunge l'endpoint del servizio MEX (Metadata Exchange) alla configurazione del servizio predefinita per supportare client che desiderano recuperare una definizione del contratto dal servizio. Forma abbreviata /x. |
/id |
Visualizza applicazione, componente e informazioni sull'interfaccia come ID. Forma abbreviata /k. |
/nologo |
Impedisce la visualizzazione del logo di ComSvcConfig.exe. Forma abbreviata /n. |
/verbose |
Restituisce tutti gli avvisi o testo informativo oltre a qualsiasi errore incontrato. Forma abbreviata /v. |
/help |
Il messaggio di utilizzo viene visualizzato. Forma abbreviata /?. |
/partial |
Genera una configurazione del servizio quando l'interfaccia specificata include una o più firme del metodo che possono essere esposte. In corrispondenza dell’ora di inizializzazione del servizio, metodi compatibili vengono visualizzati come operazioni sul contratto di servizio, mentre i metodi non compatibili vengono ignorati e non sono presenti nel contratto di servizio. Se questo flag manca, lo strumento non genererà una configurazione del servizio quando l'interfaccia specificata include uno o più metodi incompatibili. |
Esempi
Descrizione
Nell'esempio seguente viene aggiunta l'interfaccia IFinances del componente ItemOrders.IFinancial (dall'applicazione OnlineStore COM+) al set di interfacce esposte come servizi Web, utilizzando la modalità di hosting COM+. Tutti gli avvisi verranno restituiti oltre a qualsiasi errore incontrato.
Codice
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Descrizione
Nell'esempio seguente viene aggiunta l'interfaccia IStockLevels del componente ItemInventory.Warehouse (dall'applicazione OnlineWarehouse COM+) al set di interfacce esposte come servizi Web, utilizzando la modalità di hosting Web. Il Servizio Web è ospitato sul Web nella directory virtuale OnlineWarehouse di IIS.
Codice
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
Descrizione
Nell'esempio seguente viene rimossa l'interfaccia IFinances del componente ItemOrders.Financial (dall'applicazione OnlineStore COM+) dal set di interfacce esposte come servizi Web, utilizzando la modalità di hosting COM+.
Codice
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Descrizione
L’esempio di seguito riportato elenca le interfacce ospitate COM+ attualmente esposte, insieme all'indirizzo corrispondente e ai dettagli di associazione, per l'applicazione OnlineStore COM+ sul computer locale.
Codice
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus