Outil de configuration de modèle de service COM+ (ComSvcConfig.exe)
L'outil en ligne de configuration de modèle de service COM+ (ComSvcConfig.exe) permet de configurer des interfaces COM+ à exposer en tant que services Web.
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]
Notes
.gif "ms732020.note(fr-fr,VS.90).gif") Remarque : |
|---|
| Vous devez être administrateur sur l'ordinateur local pour pouvoir utiliser ComSvcConfig.exe. |
Cet outil se trouve à l'emplacement suivant :
%SystemRoot%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\
Pour plus d'informations sur ComSvcConfig.exe, consultez How To: Use the COM+ Service Model Configuration Tool.
Le tableau suivant décrit les modes qui peuvent être utilisés avec ComSvcConfig.exe.
| Option | Description |
|---|---|
install |
Installe une configuration d'interface COM+ pour l'intégration du modèle de service. Forme abrégée : /i. |
uninstall |
Désinstalle une configuration d'interface COM+ de l'intégration de modèle de service. Forme abrégée : /u. |
list |
Répertorie les informations relatives aux applications COM+ et aux composants qui possèdent des interfaces configurées pour l'intégration de modèle de service. Forme abrégée : /l. |
Le tableau suivant décrit les indicateurs qui peuvent être utilisés avec ComSvcConfig.exe.
| Option | Description |
|---|---|
/application:<ID_application | Nom_application> |
Spécifie l'application COM+ à configurer. Forme abrégée : /a. |
/contract:<ID_classe | ID_programme | *,ID_interface | Nom_interface | *> |
Spécifie le composant et l'interface COM+ qui seront configurés en tant que contrat pour le service. Forme abrégée : /c. Le caractère générique (*) peut être utilisé lors de la spécification des noms de composants et d'interfaces ; toutefois, son utilisation n'est pas recommandée, car vous risquez d'exposer des interfaces que vous ne souhaitiez pas exposer. |
/hosting:<complus | était> |
Spécifie s'il faut utiliser le mode d'hébergement COM+ ou Web. Forme abrégée : /h. L'utilisation du mode d'hébergement COM+ requiert l'activation explicite de l'application COM+. L'utilisation du mode d'hébergement Web permet à l'application COM+ d'être activée automatiquement, de façon appropriée. Si l'application COM+ est une application de bibliothèque, elle s'exécute au cours du processus de Services Internet (IIS). Si l'application COM+ est une application serveur, elle s'exécute au cours du processus Dllhost.exe. |
/webSite:<WebsiteName> |
Spécifie le site Web à utiliser pour l'hébergement lorsque le mode d'hébergement Web est utilisé (consultez l'indicateur /hosting ). Forme abrégée : /w. Si aucun site Web n'est spécifié, le site Web par défaut est utilisé. |
/webDirectory:<WebDirectoryName> |
Spécifie le répertoire virtuel à utiliser pour l'hébergement lorsque le mode d'hébergement Web est utilisé (consultez l'indicateur /hosting ). Forme abrégée : /d. |
/mex |
Ajoute un service d'échange de métadonnées (MEX, Metadata Exchange) à la configuration du service par défaut pour prendre en charge les clients qui souhaitent récupérer une définition de contrat à partir du service. Forme abrégée : /x. |
/id |
Affiche les informations sur l'application, le composant et l'interface en tant qu'ID. Forme abrégée : /k. |
/nologo |
Empêche ComSvcConfig.exe d'afficher son logo. Forme abrégée : /n. |
/verbose |
Affiche tous les avertissements ou tout le texte informatif en plus des erreurs rencontrées. Forme abrégée : /v. |
/help |
Affiche le message d'utilisation. Forme abrégée : /?. |
/partial |
Génère une configuration de service lorsque l'interface spécifiée inclut une ou plusieurs signatures de méthode qui peuvent être exposées. Au moment de l'initialisation, les méthodes compatibles apparaissent en tant qu'opérations sur le contrat de service, et les méthodes non compatibles sont ignorées et absentes du contrat de service. Si cet indicateur est manquant, l'outil ne génère pas de configuration de service lorsque l'interface spécifiée inclut une ou plusieurs méthodes incompatibles. |
Exemples
Description
L'exemple suivant ajoute l'interface IFinances du composant ItemOrders.IFinancial (de l'application COM+ OnlineStore) aux interfaces exposées en tant que services Web, à l'aide du mode d'hébergement COM+. Outre les erreurs rencontrées, l'affichage inclut tous les avertissements.
Code
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
Description
L'exemple suivant illustre l'ajout de l'interface IStockLevels du composant ItemInventory.Warehouse (de l'application COM+ OnlineWarehouse) aux interfaces exposées en tant que services Web, à l'aide du mode d'hébergement Web. Le service Web est en mode d'hébergement Web dans le répertoire virtuel OnlineWarehouse d'IIS.
Code
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse
Description
L'exemple suivant illustre la suppression de l'interface IFinances du composant ItemOrders.Financial (de l'application COM+ OnlineStore) du groupe d'interfaces exposées en tant que services Web.
Code
ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus
Description
L'exemple suivant répertoire les interfaces actuellement exposées, hébergées par COM+, ainsi que l'adresse correspondante et les détails de liaison, pour l'application COM+ OnlineStore située sur l'ordinateur local.
Code
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus