Comment : utiliser l'outil de configuration de modèle de service COM+

Article
09/12/2008

Une fois que vous avez sélectionné un mode d'hébergement approprié, utilisez l'outil en ligne de commande de configuration de modèle de service COM+ (ComSvcConfig.exe) pour configurer les interfaces d'application qui seront exposées en tant que services Web.

Remarque :
Vous devez être administrateur sur l'ordinateur pour exécuter chacune des tâches suivantes.

Pour ajouter une interface à l'ensemble des interfaces exposées en tant que services Web, à l'aide du mode d'hébergement COM+

Exécutez ComSvcConfig avec les options /install et /hosting:complus, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
```
La commande ajoute l'interface IFinances du composant ItemOrders.IFinancial (depuis l'application COM+ OnlineStore) à l'ensemble des interfaces qui seront exposées en tant que services Web. Le service utilise le mode d'hébergement COM+, et requiert par conséquent l'activation d'application explicite.

Bien que le caractère générique * puisse être utilisé pour le composant et l'interface, évitez de l'utiliser car vous souhaiterez peut-être exposer uniquement certaines fonctionnalités sélectionnées en tant que service Web. En cas d'exécution avec une version ultérieure de ce composant, l'utilisation du caractère générique peut exposer involontairement des interfaces qui étaient peut-être absentes lorsque la syntaxe de configuration a été déterminée.

L'option /verbose fait en sorte que l'outil affiche des avertissements en plus des éventuelles erreurs.

Le contrat pour le service exposé contiendra toutes les méthodes de l'interface IFinances.

Pour ajouter uniquement des méthodes spécifiques d'une interface à l'ensemble des interfaces qui seront exposées en tant que services Web, à l'aide du mode d'hébergement COM+

Exécutez ComSvcConfig avec les options /install et /hosting:complus et avec la désignation explicite des méthodes requises, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose
```
La commande ajoute uniquement les méthodes Credit et Debit de l'interface IFinances comme opérations au contrat de service exposé. Toutes les autres méthodes sur l'interface seront omises du contrat et ne pourront pas être appelées à partir de clients de service Web.

Pour ajouter une interface à l'ensemble des interfaces exposées en tant que services Web, à l'aide du mode d'hébergement Web

Exécutez ComSvcConfig avec les options /install et /hosting:was, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose
```
La commande ajoute l'interface IStockLevels sur le composant ItemInventory.Warehouse (depuis l'application COM+ OnlineWarehouse) à l'ensemble des interfaces qui seront exposées en tant que services Web. Le service étant hébergé sur le Web dans le répertoire virtuel OnlineWarehouse des services Internet (IIS) plutôt que dans COM+, l'application est activée automatiquement selon les besoins.

Pour utiliser la configuration hébergée sur le Web dans un processus, l'application COM+ doit être configurée pour s'exécuter en tant qu'application bibliothèque plutôt qu'application serveur à l'aide de la console d'administration Services de composants. Les applications configurées en tant qu'applications serveur utilisent le mode hébergé sur le Web standard et effectuent un saut de processus pour traiter chaque demande.

L'option /mex ajoute un point de terminaison de service Échange de métadonnées (MEX) supplémentaire qui utilise le même transport que le point de terminaison de service de l'application pour prendre en charge les clients qui souhaitent récupérer une définition de contrat à partir du service.

Pour supprimer un service Web pour une interface spécifiée

Exécutez ComSvcConfig avec l'option /uninstall, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus
```
La commande supprime l'interface IFinances sur le composant ItemOrders.Financial (de l'application COM+ OnlineStore).

Pour répertorier les interfaces exposées actuellement

Exécutez ComSvcConfig avec l'option /list, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /list
```
La commande répertoire les interfaces actuellement exposées, avec l'adresse correspondante et les détails de liaison, avec comme étendue l'ordinateur local.

Pour répertorier des interfaces spécifiques exposées actuellement

Exécutez ComSvcConfig avec l'option /list, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
```
La commande répertoire les interfaces hébergées par COM+ exposées actuellement, avec l'adresse correspondante et les détails de liaison, pour l'application COM+ OnlineStore sur l'ordinateur local.

Pour afficher une aide sur les options qui peuvent être utilisées avec l'utilitaire

Exécutez ComSvcConfig avec l'option /?, comme illustré dans l'exemple suivant.
```
ComSvcConfig.exe /?
```

Voir aussi

Concepts

Vue d'ensemble de l'intégration à des applications COM+

Partager via