Strumento di configurazione del modello di servizio COM+ (ComSvcConfig.exe)

Lo strumento da riga di comando COM+ Service Model Configuration (ComSvcConfig.exe) consente di configurare le interfacce COM+ da esporre 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:

Annotazioni

È necessario essere un amministratore nel computer locale per usare ComSvcConfig.exe.

Lo strumento è disponibile nella posizione seguente

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

Per altre informazioni su ComSvcConfig.exe, vedere Procedura: Usare lo strumento di configurazione del modello di servizio COM+.

Nella tabella seguente vengono descritte le modalità che è possibile usare con ComSvcConfig.exe.

Opzione	Descrizione
install	Installa una configurazione per un'interfaccia COM+ per l'integrazione del modello di servizio. Forma breve /i.
uninstall	Disinstalla una configurazione per un'interfaccia COM+ dall'integrazione del modello di servizio. Forma breve /u.
list	Elenca le informazioni su applicazioni e componenti COM+ con interfacce configurate per l'integrazione del modello di servizio. Forma breve /l.

Nella tabella seguente vengono descritti i flag che possono essere usati con ComSvcConfig.exe.

Opzione	Descrizione
/application: < ApplicationID | ApplicationName>	Specifica l'applicazione COM+ da configurare. Forma breve /a.
/contract: < ClassID | ProgID | *,InterfaceID | InterfaceName | *>	Specifica il componente e l'interfaccia COM+ che verranno configurati come contratto per il servizio. Forma breve /c. Anche se il carattere jolly (*) può essere usato quando si specificano i nomi di componente e di interfaccia, è consigliabile non usarlo, perché è possibile esporre interfacce che non si intende utilizzare.
/hosting: < complus | fui>	Specifica se utilizzare la modalità di hosting COM+ o la modalità di hosting Web. Forma breve /h. L'uso della modalità di hosting COM+ richiede l'attivazione esplicita dell'applicazione COM+. L'uso della modalità di hosting Web consente l'attivazione automatica dell'applicazione COM+ in base alle esigenze. Se l'applicazione COM+ è un'applicazione di libreria, viene eseguita nel processo di Internet Information Services (IIS). Se l'applicazione COM+ è un'applicazione server, viene eseguita nel processo di Dllhost.exe.
/webSite: < WebsiteName>	Specifica il sito Web per l'hosting quando viene usata la modalità di hosting Web (vedere il /hosting flag). Forma breve /w. Se non viene specificato alcun sito Web, viene utilizzato il sito Web predefinito.
/webDirectory: < WebDirectoryName>	Specifica la directory virtuale per l'hosting quando viene utilizzato l'hosting Web (vedere il parametro /hosting). Forma breve /d.
/mex	Aggiunge un endpoint di servizio MEX (Metadata Exchange) alla configurazione del servizio predefinita per supportare i client che desiderano recuperare una definizione del contratto dal servizio. Forma breve /x.
/id	Visualizza le informazioni sull'applicazione, il componente e l'interfaccia come ID. Forma breve /k.
/nologo	Impedisce ComSvcConfig.exe di visualizzarne il logo. Forma breve /n.
/verbose	Restituisce tutti gli avvisi o il testo informativo oltre a eventuali errori rilevati. Forma breve /v.
/help	Visualizza il messaggio di utilizzo. Forma breve /?.
/partial	Genera una configurazione del servizio quando l'interfaccia specificata include una o più firme di metodo che possono essere esposte. Al momento dell'inizializzazione del servizio, i metodi compatibili vengono visualizzati come operazioni sul contratto di servizio e i metodi non compatibili vengono ignorati e assenti dal contratto di servizio. Se questo flag non è presente, lo strumento non genererà una configurazione del servizio quando l'interfaccia specificata include uno o più metodi incompatibili.

Esempi

Descrizione

L'esempio seguente aggiunge l'interfaccia IFinances del ItemOrders.IFinancial componente (dall'applicazione OnlineStore COM+) al set di interfacce esposte come servizi Web, usando la modalità di hosting COM+. Tutti gli avvisi verranno segnalati, oltre a qualsiasi errore riscontrato.

Codice

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

Descrizione

Nell'esempio seguente viene aggiunta l'interfaccia IStockLevels del ItemInventory.Warehouse componente (dall'applicazione OnlineWarehouse COM+) al set di interfacce esposte come servizi Web, usando la modalità di hosting Web. Il servizio Web è ospitato 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 ItemOrders.Financial componente (dall'applicazione ONLINEStore COM+) dal set di interfacce esposte come servizi Web.

Codice

ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus  

Descrizione

Nell'esempio seguente sono elencate le interfacce COM+ attualmente esposte e ospitate, insieme all'indirizzo e ai dettagli di associazione corrispondenti, per l'applicazione OnlineStore COM+ sul computer locale.

Codice

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

Vedere anche

• Procedura: Usare lo strumento di configurazione del modello di servizio COM+